Sign in
v1
protected
agent-tasks

Schedule Task For Agent

Create a task that runs once at an absolute future time.

Deliberately not the streaming sibling of POST /: there is nothing to stream until the run starts, which may be days away. Repeating schedules are cron triggers, not tasks.

post/v1/agents/{agent_id}/tasks/schedule

Path parameters

agent_idstring uuid required

Request body

attachmentsstring[] nullable
descriptionstring required
parametersobject
project_idstring nullable
requires_human_approvalboolean nullable
scheduled_atstring date-time required

Response

Successful Response

agent_idstring uuid required
created_atstring required
descriptionstring required
errorstring nullable
execution_idstring nullable
failure_reasonstring nullable
idstring uuid required
parametersobject required
scheduled_atstring nullable
statusstring required
total_costnumber nullable

Changes