Retry Jobs Batch V1

Retry up to 50 failed/cancelled jobs in one call. Per-item outcomes — non-retriable jobs (wrong status, cross-tenant, unknown id) are reported in their own row…

POST /api/v1/jobs/retry-batch

cURL

curl --request POST \
  --url 'https://api.computer.stateset.app/api/v1/jobs/retry-batch' \
  --header "X-API-Key: $STATESET_COMPUTER_USE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "job_ids": [
    "3fa85f64-5717-4562-b3fc-2c963f66afa6"
  ]
}'

200

{
  "accepted": 1,
  "rejected": 1,
  "results": [
    {
      "source_job_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "new_job_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "status": "pending",
      "error": "string"
    }
  ]
}

Retry up to 50 failed/cancelled jobs in one call.

Per-item outcomes — non-retriable jobs (wrong status, cross-tenant, unknown id) are reported in their own row without blocking the others. Quota is checked once for the whole batch; if accepting all valid items would push past, the whole batch is rejected (same contract as /trigger/batch).

Idempotency is not supported at the batch level — each row creates a fresh retry. To make a retry replay-safe, use /jobs/{id}/retry one-by-one with an Idempotency-Key.

Request body

RetryBatchRequest

job_ids · string (uuid)[] · required

List of source job UUIDs to retry (1..50). Items are validated independently; non-retriable rows surface as per-row errors without blocking the rest.

Response

RetryBatchResponse

accepted · integer · required

rejected · integer · required

results · RetryBatchItemResult[] · required

Show RetryBatchItemResult

source_job_id · string · required

new_job_id · string,null

status · string,null

error · string,null

Status codes

Code	Meaning
200	Successful Response
422	Validation Error

cURL

curl --request POST \
  --url 'https://api.computer.stateset.app/api/v1/jobs/retry-batch' \
  --header "X-API-Key: $STATESET_COMPUTER_USE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "job_ids": [
    "3fa85f64-5717-4562-b3fc-2c963f66afa6"
  ]
}'

200

{
  "accepted": 1,
  "rejected": 1,
  "results": [
    {
      "source_job_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "new_job_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "status": "pending",
      "error": "string"
    }
  ]
}