Skip to main content
GET
/
runwayml
/
v1
/
tasks
/
{id}
TASK_ID="<task_id>"

curl "https://api.cometapi.com/runwayml/v1/tasks/$TASK_ID" \
  -H "Authorization: Bearer $COMETAPI_KEY"
{
  "id": "<task_id>",
  "status": "SUCCEEDED",
  "createdAt": "2026-06-10T08:45:00.000Z",
  "output": [
    "https://<provider-cdn>/<file_id>.png"
  ]
}
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.