Act on an explicit list of job IDs. The common case.

River UI lets you tick 12 rows and hit Retry. The selector-based /jobs/bulk below cannot express that, and it was the only bulk route this spec had — selecting specific rows is what operators actually do, while filter-based bulk is the rarer and far more dangerous operation. Synchronous, because the set is bounded by max_ids.

POST /jobs/actions

Error

A valid request URL is required to generate request examples

200

{
  "succeeded": [
    "<string>"
  ],
  "failed": [
    {
      "id": "<string>",
      "reason": "<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

ids · string[] · required

Maximum array length: 1000

Response

200 - application/json

Per-job action results.

succeeded · string[]

failed · object[]

Per-id failure — a job that finished before the click is not an error for the whole batch.

Show child attributes