Sign in
agent-tasks

Get a task by ID

[!NOTE] This endpoint is in public preview and is subject to change.

Returns a task by ID with its associated sessions

get/agents/tasks/{task_id}

Path parameters

task_idstring required

The unique identifier of the task.

Response

Task retrieved successfully

idstring required

Unique task identifier

urlstring

API URL for this task

html_urlstring

Web URL for this task

namestring

Human-readable name derived from the task prompt

creator_type'user' | 'organization'

Type of the task creator

state'queued' | 'in_progress' | 'completed' | 'failed' | 'idle' | 'waiting_for_user' | 'timed_out' | 'cancelled' required

Current state of the task, derived from its most recent session

session_countinteger

Number of sessions in this task

archived_atstring date-time nullable

Timestamp when the task was archived, null if not archived

updated_atstring date-time

Timestamp of the most recent update

created_atstring date-time required

Timestamp when the task was created

Changes