Skip to content

Retry Page Batch

POST /api/v1/organizations/{organization_id}/projects/{project_id}/page-batches/{batch_id}/retry

Requires project Write access. Creates a new batch containing only failed items.

{ "batchId": "00000000-0000-4000-8000-000000000003" }

202 response

Returns the new batch. Reuse this new UUID if the response is lost. New worker jobs start at attempt 1 with new identities; previous results remain available.

Failed codebase uploads must be uploaded again under new Page Import IDs and submitted as a new batch. This endpoint returns 400 for those items because their immutable S3 upload prefixes belong to the original identities.

The retry UUID is bound to the source batch. Repeating it returns the first accepted retry, even if more source items have since failed. Use a new UUID to retry those additional failures.