Retrieve a task
Returns a single task by ID, including its input/output schemas and storage configuration.
Authorizations
Secret key (sk_live_...)
Path Parameters
Unique identifier for the task (prefixed with task_).
Response
OK
A task object. Tasks are defined actions an agent can perform.
Unique identifier for the task, prefixed with task_.
Always task.
Display name for the task.
Instructions for the agent describing what this task should do.
Task status: learning, test, or live.
The agent this task belongs to. Prefixed with agt_.
JSON Schema defining the expected input for task runs.
JSON Schema defining the expected output for task runs.
Storage configuration for file capture during task execution.
Task-level settings. Supports timeout_seconds (the per-run timeout, in seconds) and sensitive (when true, the Console hides the live browser view, agent reasoning, and screenshots for this task's runs). null when no settings were set on the task, in which case runs use your plan's default timeout and the task is not sensitive.
ISO 8601 timestamp of when the resource was created.
ISO 8601 timestamp of when the resource was last updated.
Unique identifier for the API request. Include this when contacting support.