Sign in

v1

latestOpenAPI 3.1.02026-07-267724480.0 KB

Poll a Runway official-format task

Use the task id returned by an official-format Runway create endpoint. Fresh task ids can briefly return task_not_exist before the system begins returning task state. Output URLs are time-limited; download promptly and mirror to your own storage.

get/runwayml/v1/tasks/{id}

Path parameters

idstring required

Runway task id returned by the create endpoint.

Headers

X-Runway-Versionstring

Optional Runway version header, for example 2024-11-06.

Response

Current task state.

idstring required

Task ID.

status'PENDING' | 'RUNNING' | 'SUCCEEDED' | 'FAILED' required

Task status.

createdAtstring

Task creation timestamp.

outputstring[]

Output URLs returned after the task succeeds.

failurestring

Failure reason returned after the task fails.

failureCodestring

Failure code returned after the task fails.

progressnumber

Task progress.

Example response

{
  "id": "d0658ae1-bbdd-4adc-aaba-fd8070e14d79",
  "status": "SUCCEEDED",
  "createdAt": "2026-05-01T12:47:47.351Z",
  "output": [
    "https://example.com/output.mp4"
  ]
}