Skip to content

AdminQueue

The state of the job queue.

object
adapter
required

The queue the server runs, the queue setting (db, inline, cloudtasks).

string
pending_listing
required

Whether the queue lists its pending jobs (queued, running, retrying).

boolean
counts
required

The jobs by state (queued, running, retrying, dead) then type; states and types without jobs are left out. Empty without pending_listing.

Array<object>

The number of jobs of one type in one state.

object
state
required

The state of a job. queued: it has not run yet and waits for its run_at or a worker. running: a worker holds it. retrying: it ran and waits to run again. dead: it failed for good (its handler gave up, or it used up its attempts).

string
Allowed values: queued running retrying dead
type
required
string
count
required
integer format: int64
>= 1
waits
required

How long each type with due jobs that no worker holds has kept a job waiting, by type. Empty without pending_listing.

Array<object>

How long a job type has kept a job waiting.

object
type
required
string
oldest_ready_at
required

The earliest run_at among the due jobs of the type that no worker holds.

string format: date-time
oldest_ready_at

The earliest run_at among the due jobs that no worker holds: how long the queue has kept a job waiting. Omitted when no job waits, or without pending_listing.

string format: date-time

Example generated

{
"adapter": "example",
"pending_listing": true,
"counts": [
{
"state": "queued",
"type": "example",
"count": 1
}
],
"waits": [
{
"type": "example",
"oldest_ready_at": "2026-04-15T12:00:00Z"
}
],
"oldest_ready_at": "2026-04-15T12:00:00Z"
}

For LLMs and coding agents:llms.txt,llms-full.txt, llms-small.txt

Analytics on this site