Update a task

Updates a task's name, schemas, prompt, or storage configuration. Only the fields you include in the request body are updated.

task_idstring required

Unique identifier for the task (prefixed with task_).

Request body

namestring nullable

Updated display name.

{"stackTrail":"components:schemas:UpdateTaskRequest:properties:input_schema","oasType":"schema","type":"unknown","description":"Updated JSON Schema for task run input."}

{"stackTrail":"components:schemas:UpdateTaskRequest:properties:output_schema","oasType":"schema","type":"unknown","description":"Updated JSON Schema for task run output."}

promptstring nullable

Updated agent instructions.

{"stackTrail":"components:schemas:UpdateTaskRequest:properties:storage","oasType":"schema","type":"unknown","description":"Updated storage configuration."}

Response

OK

idstring required

Unique identifier for the task, prefixed with task_.

objectstring required

Always task.

namestring required

Display name for the task.

promptstring nullable required

Instructions for the agent describing what this task should do.

statusstring required

Task status: learning, test, or live.

agent_idstring required

The agent this task belongs to. Prefixed with agt_.

{"stackTrail":"components:schemas:JsonElement","oasType":"schema","type":"unknown","description":"Arbitrary JSON value."}

created_atstring date-time required

ISO 8601 timestamp of when the resource was created.

updated_atstring date-time required

ISO 8601 timestamp of when the resource was last updated.

request_idstring required

Unique identifier for the API request. Include this when contacting support.

Update a task

Path parameters

Request body

Response

Changes