Skip to main content
GET
Get machine
See error examples and recovery steps. The complete OpenAPI contract includes every response schema.

Authorizations

Authorization
string
header
required

The server's token (MIRAGE_AUTH_TOKEN) or a JWT. A daemon in the default local mode with no token accepts requests without one.

Path Parameters

workspace_id
string
required

Workspace ID.

machine_id
string
required

Machine ID in provider:name format.

Response

200 - application/json

OK

id
string
required

Machine ID in provider:name format.

state
enum<string>
required

Machine access status. managed allows inspection and control of every process started by Mirage programs. reachable limits this to processes Mirage started directly. unreachable means the latest check failed.

Available options:
managed,
reachable,
unreachable
checked_at
number
required

When the check ran, in epoch seconds.

processes
ProcessResponse · object[]
required

The processes the workspace keeps that ran on the machine.