Skip to main content
GET
Get a task

Authorizations

Authorization
string
header
required

An API key minted in Command Center (Settings -> API Keys), sent as Authorization: Bearer 2501_ak_.... A Command Center session cookie is also accepted.

Path Parameters

id
string
required

Response

The task

id
string
required
Example:

"tsk_2b7c1d4e-..."

org_id
string
required
job_id
string | null
required
agent_id
string
required
host_id
string | null
required

The host the task ran on, kept after the host is removed; null until the task is placed

description
string
required
status
enum<string>
required

completed, failed and canceled end a run. Every other value is a step of a run in progress. A standalone task can be resumed and a job reopened, which starts a new run.

Available options:
assigned,
in_progress,
failed,
completed,
planning,
initial_action_generation,
action_verification,
verification_retry,
verification_success,
verification_failed,
await_cli_input,
action_generation,
action_executor,
process_engine_action,
pending,
canceled
Example:

"completed"

read_only
boolean
required

true for a task that only reads and makes no change

execution_mode
enum<string> | null
required
deprecated

Kept for compatibility: investigate when read_only is true, else null

Available options:
investigate,
null
summary
string | null
required

The agent's account of what it did, once it has stopped

stop_reason
string | null
required
failure_kind
enum<string> | null
required

Why a failed task failed; null unless it failed

Available options:
host_unreachable,
null
rerouted_task_id
string | null
required

On a task whose host was unreachable: the task that took over its work

owner_id
string | null
required

The user who started the task

canceled_by_id
string | null
required

The user who stopped the task; null unless stopped

archived
boolean
required
scheduled_at
string<date-time> | null
required
Example:

"2026-08-26T10:00:26.380Z"

started_at
string<date-time> | null
required
Example:

"2026-08-26T10:00:26.380Z"

completed_at
string<date-time> | null
required
Example:

"2026-08-26T10:00:26.380Z"

created_at
string<date-time>
required
Example:

"2026-08-26T10:00:26.380Z"

updated_at
string<date-time>
required
Example:

"2026-08-26T10:00:26.380Z"