Skip to content

Requeue a failed or cancelled job

POST
/admin/jobs/{id}/requeue

Puts a failed or cancelled job back in the pending queue.

You need to be signed in with system.admin for the whole install; a permission held only for a team doesn’t count, and system.jobs.read doesn’t allow this action.

The update succeeds only while the stored status is failed or cancelled. It resets attempts to zero and clears the worker claim, lease, error and finish time. It keeps the job ID, type, payload, priority, attempt limit, original enqueue time, first-start time and schedule, so a future schedule still delays it. Requeueing doesn’t undo earlier side effects or guarantee that the next attempt succeeds.

A missing job returns 404. A job in any other state returns 409; this doesn’t take a running job away from its worker. After an unsuccessful update the server checks existence separately, so concurrent changes can affect which of the two you get. Another pending or running job with the same type and non-null idempotency key can block the update with a server error.

A 204 confirms this request changed the row to pending. Workers or other administrators can change it again right away. Repeating the request can return 409; racing requests get no guarantee of success or of the final state.

id
required
string format: uuid

UUID of the job to requeue.

This request changed the job to pending; its state can change again afterward.

Authentication required, missing, or invalid

object
error
required

Human-readable error summary

string
Example
the request could not be completed
Example
{
"error": "authentication required: sign in and retry with a valid session or API token"
}

Authenticated but missing required capabilities

object
error
required

Human-readable error summary

string
Example
the request could not be completed

Resource not found

object
error
required

Human-readable error summary

string
Example
the request could not be completed

Conflict (slug taken, would create cycle, etc.)

object
error
required

Human-readable error summary

string
Example
the request could not be completed