GET /aiworkflow/{work_id}

Returns the state of an AI job created by POST /aiworkflow. This is the tracking endpoint: generation is asynchronous and the creation call returns before the content exists.

📘

Authorization

Requires the account API key in the Authorization header, without the Bearer prefix.

HTTP Method & Path

GET /aiworkflow/{work_id}

Base URL: https://api-v2.pandavideo.com.br

Path Parameters

Response

Response Schema

The status lifecycle

QUEUE → RUNNING → FINISHED, or ERROR / SKIPPED.

The type vocabulary

⚠️

The job type is not the same type you send in the request.

There is also a LIPSYNC type, produced internally and not accepted in the request.

All jobs of a video

To list every job of a video instead of checking them one by one:

GET /aiworkflow?video_id={video_id}

Returns an array of jobs in the same format above. Real response of a video whose pt-BR transcription triggered two translations:

[
  {
    "id": "{work_id}",
    "organization_id": "{organization_id}",
    "video_id": "{video_id}",
    "status": "FINISHED",
    "type": "TRANSCRIPTION",
    "metadata": {
      "from_lang": "pt-BR",
      "dependent_works": ["{work_id_2}", "{work_id_3}"]
    },
    "created_at": "2026-07-08T18:41:54.450Z",
    "updated_at": "2026-07-08T18:42:03.892Z"
  },
  {
    "id": "{work_id_2}",
    "organization_id": "{organization_id}",
    "video_id": "{video_id}",
    "status": "FINISHED",
    "type": "TRANSLATE",
    "metadata": {
      "from_lang": "pt-BR",
      "to_lang": "es",
      "dependent_work": null
    },
    "created_at": "2026-07-08T18:41:54.445Z",
    "updated_at": "2026-07-08T20:14:26.665Z"
  }
]

⚠️

Important

• status: FINISHED tells you the job finished. To know what became available and in which languages, read config.ai.resources[] in GET /videos/{video_id}.
• A few seconds between checks is enough. Aggressive polling does not move the queue faster.
• dependent_works explains why a single call may show up as several jobs.

Error Responses

• 401: missing or invalid API key.
• 404: job not found (or it belongs to another organization).
• 500: internal error.

Example Usage

cURL

# One job
curl -X GET "https://api-v2.pandavideo.com.br/aiworkflow/{work_id}" \
  -H "Authorization: {api_key}"

# Every job of a video
curl -X GET "https://api-v2.pandavideo.com.br/aiworkflow?video_id={video_id}" \
  -H "Authorization: {api_key}"