Tasks
Update a task
Updates a task's name, schemas, prompt, or storage configuration. Only the fields you include in the request body are updated.
patch/tasks/{task_id}
Path parameters
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."}
{"stackTrail":"components:schemas:JsonElement","oasType":"schema","type":"unknown","description":"Arbitrary JSON value."}
{"stackTrail":"components:schemas:JsonElement","oasType":"schema","type":"unknown","description":"Arbitrary JSON value."}
{"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.