Skip to main content
POST
Retry Failed Items
After a batch completes with some failures, retry only the failed scrapes. Successful items are never touched. Fresh credits are reserved for the retry, and the batch status resets to running.

Full Retry Pattern


Response

202 Accepted:
After a successful retry:
  • Failed items reset to pending status
  • Batch failedCount decrements by retriedCount
  • Batch status resets to running
  • Poll the same batchId — it will complete again when all retried items finish

Errors

No failed items:

Get Batch Status

Poll for results after retrying

Cancel a Batch

Stop the batch entirely instead

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

batchId
string<uuid>
required

The batch ID containing failed items to retry

Response

Failed items re-queued

status
enum<string>
Available options:
queued
retriedCount
integer

Number of failed items that were re-queued