Create a scheduled task
Scheduled Tasks API
Create a scheduled task
Schedule an agent to run automatically on a cron schedule. The agent
must belong to your organization. The run executes the agent with
prompt as the user message, on the cadence in schedule.
POST
Create a scheduled task
Authorizations
JWT token from Clerk authentication.
Must be from a user with org:admin role.
Body
application/json
Maximum string length:
100Example:
"Weekly portfolio digest"
The message sent to the agent on each run.
Example:
"Summarize any new documents added this week."
Cron expression (UTC).
Example:
"0 13 * * 1"
Example:
123
Response
Task created.
Example:
42
Example:
"Weekly portfolio digest"
Example:
"Summarize any new documents added this week."
Cron expression (UTC).
Example:
"0 13 * * 1"
Example:
123
Present on list/get responses.
Example:
"Portfolio Monitor"
