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.
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ”UUID of the job to requeue.
Responses
Section titled “ Responses ”This request changed the job to pending; its state can change again afterward.
Authentication required, missing, or invalid
object
Human-readable error summary
Example
the request could not be completedExample
{ "error": "authentication required: sign in and retry with a valid session or API token"}Authenticated but missing required capabilities
object
Human-readable error summary
Example
the request could not be completedResource not found
object
Human-readable error summary
Example
the request could not be completedConflict (slug taken, would create cycle, etc.)
object
Human-readable error summary
Example
the request could not be completed