Skip to main content
POST
/
jobs
/
{id}
/
retry
Retry Job
curl --request POST \
  --url https://api.example.com/jobs/{id}/retry \
  --header 'x-api-key: <x-api-key>'
{
  "job_id": "660f9511-f30c-52e5-b827-557766551111",
  "original_job_id": "550e8400-e29b-41d4-a716-446655440000",
  "message": "Job re-queued successfully"
}

​
Overview

Re-queue a failed job with the same parameters. Creates a new job with a new ID while preserving the original job’s configuration. Only jobs with status Failed can be retried.

​
Header Parameters

​
x-api-key
string
required
Your API key for authentication

​
Path Parameters

​
id
uuid
required
The failed job UUID to retry

​
Response

​
job_id
string
UUID of the new retry job
​
original_job_id
string
UUID of the original failed job
​
message
string
Success message

​
Examples

curl -X POST "https://tornado.velys.software/jobs/550e8400-e29b-41d4-a716-446655440000/retry" \
  -H "x-api-key: sk_your_api_key"

​
Success Response

{
  "job_id": "660f9511-f30c-52e5-b827-557766551111",
  "original_job_id": "550e8400-e29b-41d4-a716-446655440000",
  "message": "Job re-queued successfully"
}

​
Error Responses

{
  "error": "Only failed jobs can be retried"
}

​
Notes

  • Only jobs with status Failed can be retried
  • A new job is created with a new UUID
  • The original failed job remains unchanged (for audit purposes)
  • All original parameters are preserved (URL, format, codecs, webhook, etc.)
  • The new job uses your current S3 configuration (in case you updated it)
  • Usage/billing is counted for the new job