Skip to main content
GET
List processes
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.

Query Parameters

session_id
string

Only this session's records; every session's when absent.

state
enum<string>

Only the records in this state.

Available options:
running,
stopping,
exited
line_id
string

Only the processes this line ran.

job_id
string

Only the processes this job ran, its own and every one under it.

machine
string

Only the processes run on this machine, written provider:name.

Response

200 - application/json

OK

command
string
required
cwd
string
required
ended_at
number | null
required
error
string | null
required
exit
integer | null
required
group
integer
required
line_id
string | null
required
machine
string
required
machine_pid
MachinePidResponse · object | null
required
parent
integer | null
required
pid
integer
required
runtime
string | null
required
session_id
string
required
signal
integer | null
required
started_at
number
required
state
string
required