Skip to main content
GET
/
v1
/
tasks
/
{task_id}
Retrieve a task
curl --request GET \
  --url https://api.infinitecreator.com/v1/tasks/{task_id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "<string>",
  "state": "PENDING",
  "failure_message": "<string>",
  "results": [
    {
      "agent_id": "<string>",
      "url": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "preview_url": "<string>",
      "metadata": {}
    }
  ],
  "dropped_assets": [
    {
      "url": "<string>",
      "reason": "<string>"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
task_id
string
required

ID of the Task

Minimum string length: 8

Response

Successful Response

​
id
string
required

Unique identifier for the object.

Example:

"01K364FEGEDX32AK5RK447H2KP"

​
state
enum<string>
default:PENDING

State of the task

Available options:
PENDING,
STARTED,
RUNNING,
FAILED,
SUCCEEDED
Examples:

"RUNNING"

"FAILED"

"SUCCEEDED"

​
failure_message
string

If task state is FAILED, this will contain a brief description of the error

​
results
TaskResult · object[]

If task state is SUCCEEDED, this will contain the results of the task

​
dropped_assets
DroppedAsset · object[]

If some of the input assets did not pass our internal checks, this will contain the assets that were dropped from the video along with a brief description of the error

Last modified on May 12, 2026