Skip to main content
POST
/
runway
/
feed
Poll a Runway compatibility-format task
curl --request POST \
  --url https://api.cometapi.com/runway/feed \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "task_id": "4156043d-9ea5-47c5-9e38-3f8446a0b20d"
}
'
{
  "task_id": "4156043d-9ea5-47c5-9e38-3f8446a0b20d"
}
Use this endpoint after you create a Runway compatibility-format task. It is the main polling step for /runway/pro/* workflows.

​
Check these fields first

  • task_id for the task identifier
  • status and progress for task progress
  • result_url, video_url, or related output fields when the task completes
  • fail_reason when the task fails

​
Polling pattern

1

Create the compatibility-format task first

Start with a compatibility-format Runway page such as Generate, Image-to-Video, Video to Video Style Redraw, or Act-one Expression Migration.
2

Retry once if the task is not visible yet

Fresh task ids can briefly return task_not_exist. If that happens, wait a few seconds and poll again.
3

Continue polling until the task is terminal

Keep checking this endpoint until the task leaves queued or in-progress states and the response includes a usable output URL.

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.

Body

application/json
​
task_id
string
required

Runway task id returned by the create endpoint.

Response

200 - application/json

Current task state.

​
task_id
string
required

Task ID returned by the create endpoint.

​
action
string

Task action.

​
status
string

Task status.

​
fail_reason
string

Failure reason, when available.

​
result_url
string

Result URL, when available.

​
submit_time
integer

Task submission timestamp.

​
start_time
integer

Task start timestamp.

​
finish_time
integer

Task finish timestamp.

​
progress
string

Task progress.

​
data
object

Task metadata.