Get Task Info

Overview

Retrieve detailed information for a single task by its ID. Returns the same fields as the List Tasks endpoint but for one specific task. Works for tasks in any state, including stopped, completed, failed, or errored tasks.

Path Parameters

Parameter	Type	Required	Description
`task_id`	string	Yes	The ID of the task to retrieve

Example Request

curl "https://api.narrative-sports.com/v1/tasks/YOUR_TASK_ID/info" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

{
  "success": "success",
  "task": {
    "task_id": "YOUR_TASK_ID",
    "project_id": 1234,
    "srt_url": "srt://<host>:9000?passphrase=SRT_PASSPHRASE",
    "task_payload": {
      "sport": "soccer",
      "srt_url": "srt://<host>:9000?passphrase=SRT_PASSPHRASE",
      "srt_zero_relative_smpte_timecode": "01:00:00:00",
      "max_life_hours": 6.0
    },
    "assigned": true,
    "time_remaining_hours": 4.25,
    "task_status": "running"
  }
}

Response Fields

Field	Type	Description
`success`	string	Result status: `success` or `failure`
`task`	object \| null	`TaskInfo` object, or `null` if not found

TaskInfo Fields

Field	Type	Description
`task_id`	string	Unique task identifier
`project_id`	number \| null	Generated project ID for this stream task. Use this value when creating recaps or highlight packages. This may be `null` until the worker has linked the task to a project.
`srt_url`	string \| null	Worker-generated SRT ingest URL (per-task host + encryption passphrase). Stream to it verbatim.
`task_payload`	object	Full task configuration payload
`assigned`	boolean	`true` if the task has been assigned work via `/create-task` (or the deprecated `/assign-task`), `false` if only warmed up via the deprecated `/warmup` endpoint
`time_remaining_hours`	number \| null	Estimated hours before auto-shutdown, or `null` for terminal states. Measured from when the worker was launched; a `scheduled` task still has its full `max_life_hours` budget.
`task_status`	string	Current status: `scheduled`, `queued`, `running`, `ready`, `stopping`, `stopped`, `error`, `failed`, `completed`, or `cancelled`.
`scheduled_start_at`	string \| null	For an `hls_pull` task created with `scheduled_start_at`: the expected stream start. `null` otherwise.

Error Responses

Task not found or not owned by caller

{
  "success": "failure",
  "task": null
}

Notes

The assigned field distinguishes between tasks that have been fully assigned work (via /tasks/create-task, or the deprecated /tasks/assign-task) and tasks that were only pre-warmed via the deprecated /tasks/warmup endpoint without subsequent assignment.
project_id is the canonical public ID for creating recaps, highlight packages, and reading project highlight options. If it is null, retry this endpoint after the task has started producing project data.
time_remaining_hours is computed from max_life_hours and the task creation time. Use Extend Task Life to increase max_life_hours for an active task.
Stream to srt_url exactly as returned — it contains the per-task host and encryption passphrase and is valid only for that task; don’t rebuild or modify it.

Overview

Task Creation

Task Management

License Usage

Deprecated

Highlights

Highlight Packages (Early Beta)

Recaps

Overview

Path Parameters

Example Request

Example Response

Response Fields

TaskInfo Fields

Error Responses

Task not found or not owned by caller

Notes

​Overview

​Path Parameters

​Example Request

​Example Response

​Response Fields

​TaskInfo Fields

​Error Responses

​Task not found or not owned by caller

​Notes

Overview

Path Parameters

Example Request

Example Response

Response Fields

TaskInfo Fields

Error Responses

Task not found or not owned by caller

Notes