Update a task
Updates a task’s name, schemas, prompt, or storage configuration. Only the fields you include in the request body are updated.
Authorizations
Secret key (sk_live_...)
Path Parameters
Unique identifier for the task (prefixed with task_).
Body
Request body for updating a task. Only include fields you want to change.
Updated display name.
Updated JSON Schema for task run input.
Updated JSON Schema for task run output.
Updated agent instructions.
Updated storage configuration.
Task-level settings. Supports timeout_seconds and sensitive. When included, settings replaces the task's settings as a whole, so send every key you want to keep.
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.