List Queue Jobs

Queue operator access

Configure durable execution with QueueConfig(durable=True) and a queue worker on this replica. Without the active queue surface, these routes return 503.

When a JWT or PAT identity is present, these operator routes require the configured admin scope, even if user isolation or general authorization is disabled. Security-key and open instances pass this operator gate. Job rows can include cross-user payloads; these are operator APIs, not a user's run-status feed.

Repeat the query parameter to match multiple states: ?status=failed&status=cancelled. Results include data and pagination meta; they are not restricted to the submitting user's jobs once the operator gate passes.

GET/queue/jobs

List job queue jobs, optionally filtered by status. Repeat the status param to match any of several (e.g. status=failed&status=cancelled for the requeueable set; status=failed alone is the dead-letter list). Useful sort_by fields: created_at (default), updated_at, completed_at, status, attempt, component_type, component_id, user_id. Unknown sort fields are ignored.

Authorization

HTTPBearer
AuthorizationBearer <token>

In: header

Query Parameters

status?array<string>|

Status filter; repeatable to match any of several statuses

limit?Limit

Number of jobs to return per page

Range1 <= value <= 1000
Default20
page?Page

Page number for pagination

Range1 <= value
Default1
sort_by?Sort By

Field to sort jobs by

Default"created_at"
sort_order?SortOrder

Sort order (asc or desc)

Default"desc"

Value in

  • "asc"
  • "desc"

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl --request GET 'https://example.com/queue/jobs'
{  "data": [    {      "id": "string",      "component_type": "string",      "component_id": "string",      "session_id": "string",      "job_type": "run",      "user_id": "string",      "payload": {},      "status": "string",      "attempt": 0,      "max_attempts": 1,      "idempotency_key": "string",      "available_at": 0,      "locked_by": "string",      "locked_at": 0,      "error": "string",      "created_at": 0,      "updated_at": 0,      "completed_at": 0    }  ],  "meta": {    "page": 0,    "limit": 20,    "total_pages": 0,    "total_count": 0,    "search_time_ms": 0  }}