API reference
Jobs
Queue status, retry and cancel (job:manage).
Paths are relative to /api/v1 on your server.
/jobs#Queue summaries
- Authorisation
- Bearer token or API key · Session cookie
- 200Success.
application/json·QueueSummary[] - 401
UNAUTHENTICATED: no session, or the access token expired.application/json·ErrorEnvelope - 403
FORBIDDEN: the account lacksjob:manage, or the library, label, age or schedule scope refuses it.application/json·ErrorEnvelope
/jobs/{queue}/{id}#Cancel a job
- Authorisation
- Bearer token or API key · Session cookie
| Parameter | In | Type | Description |
|---|---|---|---|
queue required | path | string | |
id required | path | string |
- 204Done; no body.
- 401
UNAUTHENTICATED: no session, or the access token expired.application/json·ErrorEnvelope - 403
FORBIDDEN: the account lacksjob:manage, or the library, label, age or schedule scope refuses it.application/json·ErrorEnvelope - 404
NOT_FOUND: no such thing, or not one the caller may see.application/json·ErrorEnvelope
/jobs/{queue}/{id}/retry#Retry a failed job
- Authorisation
- Bearer token or API key · Session cookie
| Parameter | In | Type | Description |
|---|---|---|---|
queue required | path | string | |
id required | path | string |
- 204Done; no body.
- 401
UNAUTHENTICATED: no session, or the access token expired.application/json·ErrorEnvelope - 403
FORBIDDEN: the account lacksjob:manage, or the library, label, age or schedule scope refuses it.application/json·ErrorEnvelope - 404
NOT_FOUND: no such thing, or not one the caller may see.application/json·ErrorEnvelope
No endpoint here matches. Try another word, or look in another area.