Skip to content
Run

Resurrect Run

Reopen an aborted run and resume scraping from where it stopped

The v1 API, for batchesSquids, tasks and runs: many calls on a schedule, delivered where you work. For one call that answers in seconds, use the API v2.
POSThttps://api.lobstr.io/v1/runs/{run_key}/resurrect

Reopen an aborted run in place, resetting only the tasks that were interrupted back to pending. Tasks already marked done are untouched — the run picks up from where the abort cut it off rather than starting over.

Headers

Authorizationstringheaderrequired

Your API authentication token. Value: Token YOUR_API_KEY

Path Parameters

run_keystringpathrequired

Hash ID of the aborted run to resurrect. Retrieve this from the List Runs endpoint.

Constraints

  • Only runs with done_reason: "aborted" can be resurrected. Any other completed run returns a RunNotAborted error.

Code Examples

curl -X POST "https://api.lobstr.io/v1/runs/RUN_HASH/resurrect" \
  -H "Authorization: Token YOUR_API_KEY"

Response

200
{
  "id": "RUN_HASH",
  "status": "PENDING",
  "is_done": false,
  "done_reason": null
}

Error Responses

400 RunNotAborted
{
  "error": "RunNotAborted",
  "message": "Only aborted runs can be resurrected."
}