Skip to main content
GET
Get a single background task by id

Headers

x-user-id
string
required

Caller's user ID. Temporary header-based identity; will be replaced by JWT auth.

Path Parameters

task_id
string
required

Response

Successful Response

Summary of a single background task for API responses.

task_id
string
required

Unique task identifier.

session_id
string
required

Session that owns this task.

agent_id
string
required

Agent that triggered this task.

tool_name
string
required

Name of the offloaded tool.

summary
string
required

Short human-readable summary of the tool invocation. May include unredacted tool arguments stored in shared task records.

status
enum<string>
required

Current lifecycle status.

Available options:
running,
completed,
failed,
cancelled
started_at
string<date-time>
required

UTC timestamp when the task was registered.

execution_started_at
string<date-time> | null

UTC timestamp when tool execution began, before offload. Null when the original start time was not recorded.

completed_at
string<date-time> | null

UTC timestamp when the task reached a terminal state, or null while still running.

error_summary
string | null

Brief failure description (only for failed tasks).