Skip to main content
GET
/
runwayml
/
v1
/
tasks
/
{id}
Poll a Runway official-format task
curl --request GET \
  --url https://api.cometapi.com/runwayml/v1/tasks/{id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "d0658ae1-bbdd-4adc-aaba-fd8070e14d79",
  "status": "SUCCEEDED",
  "createdAt": "2026-05-01T12:47:47.351Z",
  "output": [
    "https://example.com/output.mp4"
  ]
}

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

Use this endpoint to inspect a Runway task by id.

​
Check these fields first

  • id for the task identifier
  • status for the current task state
  • output for finished asset URLs when the task succeeds
  • failure and failureCode when the task fails

​
When to use it

  • After calling an official-format Runway task creation page such as text-to-image, image-to-video, video-to-video, or upscale
  • When you need this format instead of the compatibility-format feed route

​
Retry behavior

  • A freshly created task may briefly return task_not_exist
  • Wait a few seconds and retry before treating the task id as invalid
  • Once the task is visible, this route and the compatibility-format feed route can return the same queued or in-progress response

Authorizations

​
Authorization
string
header
required

Bearer token authentication. Use your CometAPI key.

Headers

​
X-Runway-Version
string

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

Path Parameters

​
id
string
required

Runway task id returned by the create endpoint.

Response

200 - application/json

Current task state.

​
id
string
required

Task ID.

​
status
enum<string>
required

Task status.

Available options:
PENDING,
RUNNING,
SUCCEEDED,
FAILED
​
createdAt
string

Task creation timestamp.

​
output
string[]

Output URLs returned after the task succeeds.

​
failure
string

Failure reason returned after the task fails.

​
failureCode
string

Failure code returned after the task fails.

​
progress
number

Task progress.