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"
}

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 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.