Retry a job
Re-queue a failed job without re-submitting the payload. The original template version and data are reused, and no request body is needed. A credit is reserved when you retry and only consumed if the PDF is generated.
Endpoint
POST
/v1/generate/jobs/:jobId/retry Requires the document:create scope.
Path parameters
| Parameter | Type | Description |
|---|---|---|
jobId | string (UUID) | The ID of the failed job to retry |
Only
failed jobs can be retried. Retrying a job in any other status returns 422 JOB_NOT_FAILED.Response
Returns 202 Accepted with the same jobId. Poll job status as normal to track completion.
Errors
| Status | Code | Cause |
|---|---|---|
404 | NOT_FOUND | Job doesn't exist in your organisation |
422 | JOB_NOT_FAILED | The job isn't in failed status |
422 | QUOTA_EXCEEDED | No credits left |
422 | DAILY_QUOTA_EXCEEDED | Your plan's daily PDF limit has been reached |
503 | — | Maintenance mode — the body includes maintenanceWindow |
curl -X POST "https://api.pdf-fox.com/v1/generate/jobs/7c9e6679-7425-40de-944b-e07fc1f90ae7/retry" \ -H "Authorization: Bearer pdfs_a1b2c3d4_xxxx"
HTTP/1.1 202 Accepted
{
"jobId": "7c9e6679-7425-40de-944b-e07fc1f90ae7"
}