Skip to main content
GET
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, or video-to-video

​
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, continue polling this endpoint until it returns a terminal state or finished output.

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.

Last modified on July 2, 2026