API v1
DocsAPI ReferenceChangelogStatusSupport

Retry Processing Job

Retries a failed processing job by re-queuing it for execution. This endpoint is used when a job has failed and is eligible for retry.

POST/api/client/v1/processing-jobs/{job_id}/retry

What this API does

  • Validates ownership of the processing job
  • Ensures the job is eligible for retry
  • Resets job state for reprocessing
  • Enqueues the job back into the processing pipeline

Authentication

https://buildvr.gretxp.com/profile/api-credentials
Headers
X-Client-ID: <YOUR_CLIENT_ID>
X-Client-Secret: <YOUR_CLIENT_SECRET>

Path Parameter

ParameterTypeRequiredDescription
job_idstring / integerYesUnique identifier of the failed processing job
Example Request
POST /processing-jobs/512/retry

Retry Rules & Constraints

  • Only failed jobs can be retried
  • Retry count must be below the maximum retry limit
  • Jobs exceeding retry limits will be permanently failed
  • Retrying does not duplicate output files
Retried jobs are re-queued asynchronously and may not start immediately.

Response

200 OK
{
  "success": true,
  "data": {
    "job_id": 512,
    "status": "queued",
    "retry_count": 2
  }
}

Possible Errors

  • 400 – job_id is missing
  • 400 – Job is not eligible for retry
  • 401 – Retry limit exceeded
  • 403 – Invalid API credentials
  • 404 – Job not found or access denied
  • 500 – Internal server error

✅ You have completed the Video Processing API documentation.