Batch

Re-run a job's failed items

Resets every item with status failed back to queued and re-dispatches it; takes no body. Succeeded, cancelled and skipped items are never re-run. If the job was terminal it goes back to queued and finished_at is cleared; if it is still running, the reset items join the current run. Item attempts is NOT reset. No items failed → a no-op returning the job unchanged with items_reset: 0. A failed item whose hold was already returned to the monthly allowance holds its price again first; 402 if the allowance cannot cover it, and then nothing is reset. Next: poll GET /v1/batch/{batchID} again.

post/v1/batch/{batchID}/retry

Request

  • Base URL: https://api.spicrawl.com
  • URL: https://api.spicrawl.com/v1/batch/{batchID}/retry
  • Auth: HTTP bearer

Response

Failed items reset. If items_dispatched < items_reset, the rest are picked up by the recovery sweep; do not call retry again for them.

items_resetinteger required

Failed items reset to queued. 0 means nothing had failed and nothing changed.

items_dispatchedinteger required

Of those, how many reached the dispatch queue now. The rest are recovered by the worker's sweep.

Example response

{
  "job": {
    "id": "01J9Z6T3W9E21T5TZARVJRVN5C",
    "project_id": "01J8X2M4C7Q1H5V9P3R6T8W0YB",
    "name": "catalog-2026-09-22",
    "status": "running",
    "status_url": "/v1/batch/01J9Z6T3W9E21T5TZARVJRVN5C",
    "results_url": "/v1/batch/01J9Z6T3W9E21T5TZARVJRVN5C/results",
    "params": {
      "js_render": true,
      "proxy_country": "us",
      "credit_budget_micro": 8000000
    },
    "total_items": 2,
    "concurrency": 20,
    "priority": 100,
    "max_attempts": 3,
    "estimated_credits": 8,
    "estimated_credits_micro": 8000000,
    "progress": {
      "total": 2,
      "completed": 1,
      "succeeded": 1,
      "failed": 0,
      "cancelled": 0,
      "skipped": 0,
      "remaining": 1,
      "percent_complete": 50,
      "credits_charged": 4,
      "credits_charged_micro": 4000000,
      "bytes": 326000
    },
    "submitted_at": "2026-09-22T06:41:12Z",
    "started_at": "2026-09-22T06:41:13Z",
    "results_expire_at": "2026-09-25T06:41:12Z"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.