Skip to main content
GET
Get process
Get a tracked process by its process ID. Ended processes are retained for up to one hour, with a maximum of 1,024 records. Servers sharing a workspace store share these records; snapshots preserve ended 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.

pid
integer
required

Process ID.

Response

200 - application/json

OK

command
string
required
cwd
string
required
ended_at
string<date-time> | null
required
error
string | null
required
exit
integer | null
required
group
integer
required
line_id
string | null
required
machine
ProcessMachineResponse · object
required
machine_pid
MachinePidResponse · object | null
required
parent
integer | null
required
pid
integer
required
session_id
string
required
signal
integer | null
required
started_at
string<date-time>
required
state
string
required