Skip to main content
GET
List jobs
List jobs tracked by workspace sessions. Filter by session, state, or command execution. 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.

Query Parameters

session_id
string

Filter by session ID. If omitted, include all sessions.

state
enum<string>

Filter by execution state.

Available options:
running,
stopping,
exited
line_id
string

Command execution ID returned as line_id by the shell endpoint.

Response

200 - application/json

OK

items
JobResponse · object[]
required