Skip to main content
GET
Get job
Get a job with its process IDs, including descendant processes still tracked by the workspace. Completed jobs remain available until the session removes them. Running wait or jobs can remove completed jobs after reporting them. 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.

job_id
string
required

Job ID returned as id by the job list endpoint, written job_ and 32 hex digits.

Response

200 - application/json

OK

command
string
required
cwd
string
required
ended_at
string<date-time> | null
required
exit
integer | null
required
group
integer | null
required
id
string
required

Job ID, written job_ and 32 hex digits. Use it with GET /v1/workspaces/{workspace_id}/jobs/{job_id}.

line_id
string | null
required
number
integer
required
pid
integer | null
required
processes
integer[]
required
session_id
string
required
signal
integer | null
required
started_at
string<date-time>
required
state
string
required