Retry an owned failed request as a new task

Creates a new request ID and preserves the failed source request for audit. Structured extraction requests also create a new recipe run.

POST
/api/v1/data/requests/{id}/retry

Creates a new request ID and preserves the failed source request for audit. Structured extraction requests also create a new recipe run.

Authorization

headerX-API-Key<token>

Path Parameters

id*string
Formatuuid

Header Parameters

Idempotency-Key?string

Optional. Generate a unique value before a write and retain it for an exact-body retry; replay is free and a different body returns 409 IDEMPOTENCY_CONFLICT.

Length8 <= length <= 200

Response Body

Retry accepted or idempotently replayed Error body uses the documented PublicError DTO.

application/json
  1. response
id*string
Formatuuid
url?string

Target origin only; path and query are stored in the encrypted short-retention payload.

Formaturi
status*DataJobStatus
Value in"pending""running""solving_captcha""completed""failed""cancelled"
cached*boolean
protected*boolean

True after server-side anti-bot protection detection.

pricing_version*integer
Range1 <= value
route_mode*string
Value in"direct""auto""browser""http""residential""residential_browser""mixed"
proxy_type?ProxyNetworkType

Requested proxy network class. Present on new submissions; historical idempotent replays may omit this field.

Value in"datacenter""residential""premium"
base_tokens*integer
Range0 <= value
protected_tokens*integer

Historical compatibility field; built-in protection is included in the selected pricing-v2 request mode.

Range0 <= value
captcha_tokens*integer
Range0 <= value
quote?|

Provider-neutral admission quote. Null when the guarded pricing policy is disabled.

created_at*string
Formatdate-time
charged_tokens*integer

Base credits charged by this submission operation; dynamic protected/CAPTCHA debits occur later. Zero on an idempotent replay.

Range0 <= value
idempotent_replay*boolean

True only when this response replays a previous submission with the same idempotency key and payload.

result_kind?"extraction"

Present for structured extraction requests.

Value in"extraction"
page_status?string

Underlying page-fetch status for extraction requests; top-level status tracks extraction readiness.

retried_from_id*string

Failed source request retained for audit.

Formatuuid
retried_from_run_id?string

Present when retrying a structured extraction request.

Formatuuid
curl -X POST 'https://api.runharvester.com/api/v1/data/requests/497f6eca-6276-4993-bfeb-53cbbbba6f08/retry' \  --header "X-API-Key: ${RUNHARVESTER_API_KEY:?Set your Data API key}" \  --header "Idempotency-Key: ${RUNHARVESTER_IDEMPOTENCY_KEY:?Set a unique key for this submission; reuse it for retries}"

{  "id": "9a20bd58-ed33-4a5b-b63f-b52bb1a62248",  "url": "https://example.com",  "status": "pending",  "cached": false,  "protected": false,  "pricing_version": 2,  "route_mode": "http",  "base_tokens": 1,  "protected_tokens": 0,  "captcha_tokens": 0,  "created_at": "2026-08-22T12:00:00.000Z",  "charged_tokens": 1,  "idempotent_replay": false}