Bulk retry/archive/delete/cancel. ASYNCHRONOUS by construction.

asynq has RunAllScheduledTasks/DeleteAllRetryTasks/ArchiveAllPendingTasks and this spec originally had no equivalent — retrying 100k jobs one HTTP call at a time is not an API. A synchronous unbounded write is unsafe, so a bulk request returns an operation to poll rather than blocking. Requires Idempotency-Key.

POST /jobs/bulk

Error

A valid request URL is required to generate request examples

202

{
  "id": "<string>",
  "status": "pending",
  "affected": 123,
  "total_estimated": 123,
  "dry_run": true,
  "error": "<string>"
}

Headers

Idempotency-Key · string · required

Required on every mutating request. A double-clicked Retry, or a proxy retrying a POST, must not enqueue the job twice. Keys are retained long enough to cover a client retry window and the response is replayed verbatim.

Body

application/json

action · enum<string> · required

Available options: retry, archive, delete, cancel

selector · object · required

Same filters as GET /jobs. An empty selector is rejected — no accidental delete-everything.

Show child attributes

dry_run · boolean · default: false

Return the count that WOULD be affected.

Response

202

application/json

Bulk operation accepted.

id · string · required

status · enum<string> · required

Available options: pending, running, completed, failed

affected · integer · required

total_estimated · integer

dry_run · boolean

error · string | null