Orchestrator endpoints

This document contains the endpoints for the Orchestrator category.

Gets all hosts from the orchestrator

/api/v1/orchestrator/hosts Authorized

This endpoint returns all hosts from the orchestrator

Gets a host from the orchestrator

/api/v1/orchestrator/hosts/{id} Authorized

This endpoint returns a host from the orchestrator

Parameters
Name Type In Required Description
id string path required Host ID

Gets a host hardware info from the orchestrator

/api/v1/orchestrator/hosts/{id}/hardware Authorized

This endpoint returns a host hardware info from the orchestrator

Parameters
Name Type In Required Description
id string path required Host ID

Register a Host in the orchestrator

/api/v1/orchestrator/hosts Authorized

This endpoint register a host in the orchestrator

Parameters
Name Type In Required Description
hostRequest object body optional Host Request
Schema
{ object }

Unregister a host from the orchestrator

/api/v1/orchestrator/hosts/{id} Authorized

This endpoint unregister a host from the orchestrator

Parameters
Name Type In Required Description
id string path required Host ID

Enable a host in the orchestrator

/api/v1/orchestrator/hosts/{id}/enable Authorized

This endpoint will enable an existing host in the orchestrator

Disable a host in the orchestrator

/api/v1/orchestrator/hosts/{id}/disable Authorized

This endpoint will disable an existing host in the orchestrator

Update a Host in the orchestrator

/api/v1/orchestrator/hosts Authorized

This endpoint updates a host in the orchestrator

Parameters
Name Type In Required Description
hostRequest object body optional Host Update Request
Schema
{ object }

Get orchestrator resource overview

/api/v1/orchestrator/overview/resources Authorized

This endpoint returns orchestrator resource overview

Get orchestrator host resources

/api/v1/orchestrator/overview/{id}/resources Authorized

This endpoint returns orchestrator host resources

Parameters
Name Type In Required Description
id string path required Host ID

Get orchestrator Virtual Machines

/api/v1/orchestrator/machines Authorized

This endpoint returns orchestrator Virtual Machines

Get orchestrator Virtual Machine

/api/v1/orchestrator/machines/{id} Authorized

This endpoint returns orchestrator Virtual Machine by its ID

Deletes orchestrator virtual machine

/api/v1/orchestrator/machines/{id} Authorized

This endpoint deletes orchestrator virtual machine

Parameters
Name Type In Required Description
id string path required Virtual Machine ID
force query query optional -

Get orchestrator virtual machine status

/api/v1/orchestrator/machines/{id}/status Authorized

This endpoint returns orchestrator virtual machine status

Parameters
Name Type In Required Description
id string path required Virtual Machine ID

Renames orchestrator virtual machine

/api/v1/orchestrator/machines/{id}/rename Authorized

This endpoint renames orchestrator virtual machine

Parameters
Name Type In Required Description
id string path required Virtual Machine ID

Configures orchestrator virtual machine

/api/v1/orchestrator/machines/{id}/set Authorized

This endpoint configures orchestrator virtual machine

Parameters
Name Type In Required Description
id string path required Virtual Machine ID

Starts orchestrator virtual machine

/api/v1/orchestrator/machines/{id}/start Authorized

This endpoint starts orchestrator virtual machine

Parameters
Name Type In Required Description
id string path required Virtual Machine ID

Stops orchestrator virtual machine

/api/v1/orchestrator/machines/{id}/stop Authorized

This endpoint sops orchestrator virtual machine

Parameters
Name Type In Required Description
id string path required Virtual Machine ID
force query query optional -

Restarts orchestrator virtual machine

/api/v1/orchestrator/machines/{id}/restart Authorized

This endpoint restarts orchestrator virtual machine

Parameters
Name Type In Required Description
id string path required Virtual Machine ID

Suspends orchestrator virtual machine

/api/v1/orchestrator/machines/{id}/suspend Authorized

This endpoint suspends orchestrator virtual machine

Parameters
Name Type In Required Description
id string path required Virtual Machine ID

Resumes orchestrator virtual machine

/api/v1/orchestrator/machines/{id}/resume Authorized

This endpoint resumes orchestrator virtual machine

Parameters
Name Type In Required Description
id string path required Virtual Machine ID

Resets orchestrator virtual machine

/api/v1/orchestrator/machines/{id}/reset Authorized

This endpoint resets orchestrator virtual machine

Parameters
Name Type In Required Description
id string path required Virtual Machine ID

Pauses orchestrator virtual machine

/api/v1/orchestrator/machines/{id}/pause Authorized

This endpoint pauses orchestrator virtual machine

Parameters
Name Type In Required Description
id string path required Virtual Machine ID

Clones orchestrator virtual machine

/api/v1/orchestrator/machines/{id}/clone Authorized

This endpoint clones orchestrator virtual machine

Parameters
Name Type In Required Description
id string path required Virtual Machine ID
configRequest object body optional Machine Clone Request
Schema
{ object }

Executes a command in a orchestrator virtual machine

/api/v1/orchestrator/machines/{id}/execute Authorized

This endpoint executes a command in a orchestrator virtual machine

Parameters
Name Type In Required Description
id string path required Virtual Machine ID

Get orchestrator host virtual machines

/api/v1/orchestrator/hosts/{id}/machines Authorized

This endpoint returns orchestrator host virtual machines

Parameters
Name Type In Required Description
id string path required Host ID

Get orchestrator host virtual machine

/api/v1/orchestrator/hosts/{id}/machines/{vmId} Authorized

This endpoint returns orchestrator host virtual machine

Parameters
Name Type In Required Description
id string path required Host ID
vmId string path required Virtual Machine ID

Deletes orchestrator host virtual machine

/api/v1/orchestrator/hosts/{id}/machines/{vmId} Authorized

This endpoint deletes orchestrator host virtual machine

Parameters
Name Type In Required Description
id string path required Host ID
vmId string path required Virtual Machine ID
force query query optional -

Get orchestrator host virtual machine status

/api/v1/orchestrator/hosts/{id}/machines/{vmId}/status Authorized

This endpoint returns orchestrator host virtual machine status

Parameters
Name Type In Required Description
id string path required Host ID
vmId string path required Virtual Machine ID

Renames orchestrator host virtual machine

/api/v1/orchestrator/hosts/{id}/machines/{vmId}/rename Authorized

This endpoint renames orchestrator host virtual machine

Parameters
Name Type In Required Description
id string path required Host ID
vmId string path required Virtual Machine ID

Configures orchestrator host virtual machine

/api/v1/orchestrator/hosts/{id}/machines/{vmId}/set Authorized

This endpoint configures orchestrator host virtual machine

Parameters
Name Type In Required Description
id string path required Host ID
vmId string path required Virtual Machine ID

Starts orchestrator host virtual machine

/api/v1/orchestrator/hosts/{id}/machines/{vmId}/start Authorized

This endpoint starts orchestrator host virtual machine

Parameters
Name Type In Required Description
id string path required Host ID
vmId string path required Virtual Machine ID

Stops orchestrator host virtual machine

/api/v1/orchestrator/hosts/{id}/machines/{vmId}/stop Authorized

This endpoint stops orchestrator host virtual machine

Parameters
Name Type In Required Description
id string path required Host ID
vmId string path required Virtual Machine ID
force query query optional -

Restarts orchestrator host virtual machine

/api/v1/orchestrator/hosts/{id}/machines/{vmId}/restart Authorized

This endpoint restarts orchestrator host virtual machine

Parameters
Name Type In Required Description
id string path required Host ID
vmId string path required Virtual Machine ID

Suspends orchestrator host virtual machine

/api/v1/orchestrator/hosts/{id}/machines/{vmId}/suspend Authorized

This endpoint suspends orchestrator host virtual machine

Parameters
Name Type In Required Description
id string path required Host ID
vmId string path required Virtual Machine ID

Resumes orchestrator host virtual machine

/api/v1/orchestrator/hosts/{id}/machines/{vmId}/resume Authorized

This endpoint resumes orchestrator host virtual machine

Parameters
Name Type In Required Description
id string path required Host ID
vmId string path required Virtual Machine ID

Resets orchestrator host virtual machine

/api/v1/orchestrator/hosts/{id}/machines/{vmId}/reset Authorized

This endpoint resets orchestrator host virtual machine

Parameters
Name Type In Required Description
id string path required Host ID
vmId string path required Virtual Machine ID

Pauses orchestrator host virtual machine

/api/v1/orchestrator/hosts/{id}/machines/{vmId}/pause Authorized

This endpoint pauses orchestrator host virtual machine

Parameters
Name Type In Required Description
id string path required Host ID
vmId string path required Virtual Machine ID

Clones orchestrator host virtual machine

/api/v1/orchestrator/hosts/{id}/machines/{vmId}/clone Authorized

This endpoint clones orchestrator host virtual machine

Parameters
Name Type In Required Description
id string path required Host ID
vmId string path required Virtual Machine ID
configRequest object body optional Machine Clone Request
Schema
{ object }

Executes a command in a orchestrator host virtual machine

/api/v1/orchestrator/hosts/{id}/machines/{vmId}/execute Authorized

This endpoint executes a command in a orchestrator host virtual machine

Parameters
Name Type In Required Description
id string path required Host ID
vmId string path required Virtual Machine ID

Lists snapshots of orchestrator host virtual machine

/api/v1/orchestrator/hosts/{id}/machines/{vmId}/snapshots Authorized

This endpoint lists snapshots of orchestrator host virtual machine

Parameters
Name Type In Required Description
id string path required Host ID
vmId string path required Virtual Machine ID

Creates a snapshot for orchestrator host virtual machine

/api/v1/orchestrator/hosts/{id}/machines/{vmId}/snapshots Authorized

This endpoint creates a snapshot for orchestrator host virtual machine

Parameters
Name Type In Required Description
id string path required Host ID
vmId string path required Virtual Machine ID
createRequest object body optional Create Snapshot Request
Schema
{ object }

Deletes all snapshots of orchestrator host virtual machine

/api/v1/orchestrator/hosts/{id}/machines/{vmId}/snapshots Authorized

This endpoint deletes all snapshots of orchestrator host virtual machine

Parameters
Name Type In Required Description
id string path required Host ID
vmId string path required Virtual Machine ID

Deletes a snapshot of orchestrator host virtual machine

/api/v1/orchestrator/hosts/{id}/machines/{vmId}/snapshots/{snapshot_id} Authorized

This endpoint deletes a snapshot of orchestrator host virtual machine

Parameters
Name Type In Required Description
id string path required Host ID
vmId string path required Virtual Machine ID
snapshot_id string path required Snapshot ID

Reverts orchestrator host virtual machine to a snapshot

/api/v1/orchestrator/hosts/{id}/machines/{vmId}/snapshots/{snapshot_id}/revert Authorized

This endpoint reverts orchestrator host virtual machine to a snapshot

Parameters
Name Type In Required Description
id string path required Host ID
vmId string path required Virtual Machine ID
snapshot_id string path required Snapshot ID
revertRequest object body optional Revert Snapshot Request
Schema
{ object }

Lists snapshots of an orchestrator virtual machine

/api/v1/orchestrator/machines/{id}/snapshots Authorized

This endpoint lists snapshots of an orchestrator virtual machine (host resolved automatically)

Parameters
Name Type In Required Description
id string path required Virtual Machine ID

Creates a snapshot for an orchestrator virtual machine

/api/v1/orchestrator/machines/{id}/snapshots Authorized

This endpoint creates a snapshot for an orchestrator virtual machine (host resolved automatically)

Parameters
Name Type In Required Description
id string path required Virtual Machine ID
createRequest object body optional Create Snapshot Request
Schema
{ object }

Deletes all snapshots of an orchestrator virtual machine

/api/v1/orchestrator/machines/{id}/snapshots Authorized

This endpoint deletes all snapshots of an orchestrator virtual machine (host resolved automatically)

Parameters
Name Type In Required Description
id string path required Virtual Machine ID

Deletes a snapshot of an orchestrator virtual machine

/api/v1/orchestrator/machines/{id}/snapshots/{snapshot_id} Authorized

This endpoint deletes a snapshot of an orchestrator virtual machine (host resolved automatically)

Parameters
Name Type In Required Description
id string path required Virtual Machine ID
snapshot_id string path required Snapshot ID

Reverts an orchestrator virtual machine to a snapshot

/api/v1/orchestrator/machines/{id}/snapshots/{snapshot_id}/revert Authorized

This endpoint reverts an orchestrator virtual machine to a snapshot (host resolved automatically)

Parameters
Name Type In Required Description
id string path required Virtual Machine ID
snapshot_id string path required Snapshot ID
revertRequest object body optional Revert Snapshot Request
Schema
{ object }

Register a virtual machine in a orchestrator host

/api/v1/orchestrator/hosts/{id}/machines/register Authorized

This endpoint registers a virtual machine in a orchestrator host

Parameters
Name Type In Required Description
id string path required Host ID
request object body optional Register Virtual Machine Request
Schema
{ object }

Unregister a virtual machine in a orchestrator host

/api/v1/orchestrator/hosts/{id}/machines/{vmId}/unregister Authorized

This endpoint unregister a virtual machine in a orchestrator host

Parameters
Name Type In Required Description
id string path required Host ID
vmId string path required Virtual Machine ID
request object body optional Register Virtual Machine Request
Schema
{ object }

Creates a orchestrator host virtual machine

/api/v1/orchestrator/hosts/{id}/machines Authorized

This endpoint creates a orchestrator host virtual machine

Parameters
Name Type In Required Description
id string path required Host ID
request object body optional Create Virtual Machine Request
Schema
{ object }

Creates a virtual machine in one of the hosts for the orchestrator

/api/v1/orchestrator/machines Authorized

This endpoint creates a virtual machine in one of the hosts for the orchestrator

Parameters
Name Type In Required Description
request object body optional Create Virtual Machine Request
Schema
{ object }

Gets orchestrator host reverse proxy configuration

/api/v1/orchestrator/hosts/{id}/reverse-proxy Authorized

This endpoint returns orchestrator host reverse proxy configuration

Parameters
Name Type In Required Description
id string path required Host ID

Gets orchestrator host reverse proxy hosts

/api/v1/orchestrator/hosts/{id}/reverse-proxy/hosts Authorized

This endpoint returns orchestrator host reverse proxy hosts

Parameters
Name Type In Required Description
id string path required Host ID

Gets orchestrator host reverse proxy hosts

/api/v1/orchestrator/hosts/{id}/reverse-proxy/hosts/{reverse_proxy_host_id} Authorized

This endpoint returns orchestrator host reverse proxy hosts

Parameters
Name Type In Required Description
id string path required Host ID

Creates a orchestrator host reverse proxy host

/api/v1/orchestrator/hosts/{id}/reverse-proxy/hosts Authorized

This endpoint creates a orchestrator host reverse proxy host

Parameters
Name Type In Required Description
request object body optional Create Host Reverse Proxy Host Request
Schema
{ object }

Updates an orchestrator host reverse proxy host

/api/v1/orchestrator/hosts/{id}/reverse-proxy/hosts/{reverse_proxy_host_id} Authorized

This endpoint updates an orchestrator host reverse proxy host

Parameters
Name Type In Required Description
request object body optional Update Host Reverse Proxy Host Request
Schema
{ object }

Deletes an orchestrator host reverse proxy host

/api/v1/orchestrator/hosts/{id}/reverse-proxy/hosts/{reverse_proxy_host_id} Authorized

This endpoint deletes an orchestrator host reverse proxy host

Parameters
Name Type In Required Description
id string path required Host ID
reverse_proxy_host_id string path required Reverse Proxy Host ID

Upserts an orchestrator host reverse proxy host http route

/api/v1/orchestrator/hosts/{id}/reverse-proxy/hosts/{reverse_proxy_host_id}/http_routes Authorized

This endpoint upserts an orchestrator host reverse proxy host http route

Parameters
Name Type In Required Description
request object body optional Upsert Host Reverse Proxy Host Http Routes Request
Schema
{ object }

Deletes an orchestrator host reverse proxy host http route

/api/v1/orchestrator/hosts/{id}/reverse-proxy/hosts/{reverse_proxy_host_id}/http_routes/{route_id} Authorized

This endpoint deletes an orchestrator host reverse proxy host http route

Parameters
Name Type In Required Description
id string path required Host ID
reverse_proxy_host_id string path required Reverse Proxy Host ID
route_id string path required Route ID

Update an orchestrator host reverse proxy host tcp route

/api/v1/orchestrator/hosts/{id}/reverse-proxy/hosts/{reverse_proxy_host_id}/tcp_route Authorized

This endpoint updates an orchestrator host reverse proxy host tcp route

Parameters
Name Type In Required Description
request object body optional Update Host Reverse Proxy Host tcp Routes Request
Schema
{ object }

Restarts orchestrator host reverse proxy

/api/v1/orchestrator/hosts/{id}/reverse-proxy/restart Authorized

This endpoint restarts orchestrator host reverse proxy

Parameters
Name Type In Required Description
id string path required Host ID

Enables orchestrator host reverse proxy

/api/v1/orchestrator/hosts/{id}/reverse-proxy/enable Authorized

This endpoint enables orchestrator host reverse proxy

Parameters
Name Type In Required Description
id string path required Host ID

Disables orchestrator host reverse proxy

/api/v1/orchestrator/hosts/{id}/reverse-proxy/disable Authorized

This endpoint disables orchestrator host reverse proxy

Parameters
Name Type In Required Description
id string path required Host ID

Gets orchestrator host catalog cache

/api/v1/orchestrator/hosts/{id}/catalog/cache Authorized

This endpoint returns orchestrator host catalog cache

Parameters
Name Type In Required Description
id string path required Host ID

Deletes an orchestrator host cache items

/api/v1/orchestrator/hosts/{id}/catalog/cache Authorized

This endpoint deletes an orchestrator host cache items

Parameters
Name Type In Required Description
id string path required Host ID

Deletes an orchestrator host cache item and all its children

/api/v1/orchestrator/hosts/{id}/catalog/cache/{catalog_id} Authorized

This endpoint deletes an orchestrator host cache item and all its children

Parameters
Name Type In Required Description
id string path required Host ID
catalog_id string path required Catalog ID

Deletes an orchestrator host cache item and all its children

/api/v1/orchestrator/hosts/{id}/catalog/cache/{catalog_id}/{catalog_version} Authorized

This endpoint deletes an orchestrator host cache item and all its children

Parameters
Name Type In Required Description
id string path required Host ID
catalog_id string path required Catalog ID
catalog_version string path required Catalog Version

Create an enrollment token

/api/v1/orchestrator/enrollment-token Authorized

Generates a short-lived, single-use token that allows a freshly installed agent to register itself with the orchestrator without requiring a permanent credential.

Parameters
Name Type In Required Description
request object body optional Enrollment token request
Schema
{ object }

Validate an enrollment token

/api/v1/orchestrator/enrollment-token/{token}/validate Authorized

Public endpoint that checks whether an enrollment token is valid, unused, and not expired. Used by agents before starting the registration flow.

Parameters
Name Type In Required Description
token string path required Enrollment token value

Deploy and register an agent via SSH (synchronous)

/api/v1/orchestrator/hosts/deploy Authorized

SSHes into a remote host, installs the devops agent, and registers it with this orchestrator. Blocks until the operation completes.

Parameters
Name Type In Required Description
request object body optional Deploy request
Schema
{ object }

Deploy and register an agent via SSH (asynchronous)

/api/v1/orchestrator/hosts/deploy/async Authorized

SSHes into a remote host, installs the devops agent, and registers it with this orchestrator. Returns a job ID immediately; poll /jobs/{id} for status.

Parameters
Name Type In Required Description
request object body optional Deploy request
Schema
{ object }

Creates a virtual machine in one of the orchestrator hosts asynchronously

/api/v1/orchestrator/machines/async Authorized

This endpoint creates a virtual machine in one of the orchestrator hosts in the background and returns a Job ID to track progress

Parameters
Name Type In Required Description
request object body optional Create Virtual Machine Request
Schema
{ object }

Creates a virtual machine in a specific orchestrator host asynchronously

/api/v1/orchestrator/hosts/{id}/machines/async Authorized

This endpoint creates a virtual machine in a specific orchestrator host in the background and returns a Job ID to track progress

Parameters
Name Type In Required Description
id string path required Host ID
request object body optional Create Virtual Machine Request
Schema
{ object }