Skip to main content
GET
Get command
Get a command execution with its job IDs and the processes it ran, each under the one that started it and naming the machine it ran on. Use the line_id returned by the shell endpoint. Completed commands are retained for up to one hour, with a maximum of 1,024 records. Servers sharing a workspace store share these records; snapshots preserve completed records. Times are RFC 3339 strings in UTC.
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.

line_id
string
required

Command execution ID returned as line_id by the shell endpoint.

Response

200 - application/json

OK

command
string
required
ended_at
string<date-time> | null
required
error
string | null
required
exit
integer | null
required
id
string
required
jobs
string[]
required

IDs of the jobs the line started, each job_ and 32 hex digits.

processes
ProcessTreeResponse · object[]
required

The processes the line ran, each under the one that started it.

session_id
string
required
signal
integer | null
required
started_at
string<date-time>
required
state
enum<string>
required
Available options:
waiting,
running,
stopping,
exited