Machines endpoints

This document contains the endpoints for the Machines category.

Gets all the virtual machines

/api/v1/machines Authorized

This endpoint returns all the virtual machines

Parameters
Name Type In Required Description
filter header header optional -

Gets a virtual machine

/api/v1/machines/{id} Authorized

This endpoint returns a virtual machine

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

Starts a virtual machine

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

This endpoint starts a virtual machine

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

Stops a virtual machine

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

This endpoint stops a virtual machine

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

Restarts a virtual machine

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

This endpoint restarts a virtual machine

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

Suspends a virtual machine

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

This endpoint suspends a virtual machine

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

Resumes a virtual machine

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

This endpoint resumes a virtual machine

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

Reset a virtual machine

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

This endpoint reset a virtual machine

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

Pauses a virtual machine

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

This endpoint pauses a virtual machine

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

Deletes a virtual machine

/api/v1/machines/{id} Authorized

This endpoint deletes a virtual machine

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

Get the current state of a virtual machine

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

This endpoint returns the current state of a virtual machine

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

Configures a virtual machine

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

This endpoint configures a virtual machine

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

Clones a virtual machine

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

This endpoint clones a virtual machine

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

Executes a command on a virtual machine

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

This endpoint executes a command on a virtual machine

Parameters
Name Type In Required Description
id string path required Machine ID
executeRequest object body optional Machine Execute Command Request
Schema
{ object }

Uploads a file to a virtual machine

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

This endpoint executes a command on a virtual machine

Parameters
Name Type In Required Description
id string path required Machine ID
executeRequest object body optional Machine Upload file Command Request
Schema
{ object }

Renames a virtual machine

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

This endpoint Renames a virtual machine

Parameters
Name Type In Required Description
id string path required Machine ID
renameRequest object body optional Machine Rename Request
Schema
{ object }

Registers a virtual machine

/api/v1/machines/register Authorized

This endpoint registers a virtual machine

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

Unregister a virtual machine

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

This endpoint unregister a virtual machine

Parameters
Name Type In Required Description
id string path required Machine ID
unregisterRequest object body optional Machine Unregister Request
Schema
{ object }

Creates a virtual machine

/api/v1/machines Authorized

This endpoint creates a virtual machine

Parameters
Name Type In Required Description
createRequest object body optional New Machine Request
Schema
{ object }

Creates a virtual machine asynchronously

/api/v1/machines/async Authorized

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

Parameters
Name Type In Required Description
createRequest object body optional New Machine Request
Schema
{ object }

Creates a snapshot for a virtual machine

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

This endpoint creates a snapshot for a virtual machine

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

Deletes a snapshot of a virtual machine

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

This endpoint deletes a snapshot of a virtual machine

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

Deletes all snapshots of a virtual machine

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

This endpoint deletes all snapshots of a virtual machine

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

Lists snapshots of a virtual machine

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

This endpoint lists snapshots of a virtual machine

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

Reverts a virtual machine to a snapshot

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

This endpoint reverts a virtual machine to a snapshot

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