Skip to content

AdminJobPage

A page of jobs.

object
next_cursor

An opaque pagination cursor. Clients pass it back unchanged and never parse it.

string
>= 1 characters <= 256 characters
items
required
Array<object>

A job of the job queue.

object
id
required

The ID of a resource, a UUIDv7 in its canonical string form.

string format: uuid
type
required

The job type, such as federation.deliver.

string
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
payload
required

The job’s payload, a JSON document as text.

string
idempotency_key
string
ordering_key
string
attempts
required

The number of runs the job had, the one in progress included.

integer
last_error

Why the last run failed; omitted for a job whose runs did not fail.

string
run_at

When a pending job is due; omitted for a dead job.

string format: date-time
worker

The worker that runs a running job.

string
locked_until

When the lease of a running job ends; another worker may run it after.

string format: date-time
created_at
required
string format: date-time
failed_at

When a dead job failed.

string format: date-time

Example generated

{
"next_cursor": "example",
"items": [
{
"id": "01890a5d-ac96-774b-bcce-b302099a8057",
"type": "example",
"state": "queued",
"payload": "example",
"idempotency_key": "example",
"ordering_key": "example",
"attempts": 1,
"last_error": "example",
"run_at": "2026-04-15T12:00:00Z",
"worker": "example",
"locked_until": "2026-04-15T12:00:00Z",
"created_at": "2026-04-15T12:00:00Z",
"failed_at": "2026-04-15T12:00:00Z"
}
]
}

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

Analytics on this site