Skip to main content
GET
Get a 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

The workspace's id.

machine_id
string
required

The machine's id, written provider:name.

Response

200 - application/json

OK

id
string
required

The machine's id, written provider:name.

state
enum<string>
required

How far Mirage reaches a machine, as its last check found it: managed (Mirage sees and stops every process its programs start there), reachable (only what it started itself) or unreachable (the last 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.