Jobs

Get Video Render Job by ID

Changed on

Retrieves the status and results of a video render job by its UUID. While a job is processing, the response contains progress information. Once completed, it returns all output URLs (video, audio, thumbnail, subtitle files). Poll this endpoint every 10-30 seconds, or use the webhook field on the render request for push notifications.

get/pictoryapis/v1/jobs/{jobid}

Request

  • Base URL
    https://api.pictory.ai
  • Auth
    API key in header Authorization

Path parameters

jobidstring uuid required

The unique UUID of the render job, returned by any render endpoint.

Response

Job status retrieved. Inspect data.status for in-progress, completed, or failed. Note that success: false with status: failed is also returned with HTTP 200.

job_idstring uuid
idstring

Alternate identifier present in the JOB_NOT_FOUND error response

successboolean

Changes

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status