Skip to main content
POST
Schedule Task For Agent

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

agent_id
string<uuid>
required
workspace
string
required

Slug of the workspace the request acts in

Maximum string length: 120
Pattern: ^[a-z0-9]+(?:-[a-z0-9]+)*$

Body

application/json

A task to run once, at a time the caller picks.

description
string
required
scheduled_at
string<date-time>
required
attachments
string[] | null
execution
RunExecutionConfig · object | null

Caller-requested execution ceiling; governance may only tighten it.

parameters
Parameters · object
project_id
string | null
requires_human_approval
boolean | null
default:false
task_policy
PolicyDocument · object | null

Source policy document stored per scope.

Response

Successful Response

agent_id
string<uuid>
required
created_at
string<date-time>
required
description
string
required
id
string<uuid>
required
parameters
Parameters · object
required
status
string
required
created_by
string | null
error
string | null
execution_id
string | null
failure_reason
string | null
provenance
TaskProvenance · object

Why a task exists: who or what started it, and the event that caused it.

result
scheduled_at
string<date-time> | null
total_cost
number | null
Last modified on October 12, 2026