Skip to main content
POST
Create a scheduled task

Authorizations

Authorization
string
header
required

JWT token from Clerk authentication.

Must be from a user with org:admin role.

Body

application/json
name
string
required
Maximum string length: 100
Example:

"Weekly portfolio digest"

prompt
string
required

The message sent to the agent on each run.

Example:

"Summarize any new documents added this week."

schedule
string
required

Cron expression (UTC).

Example:

"0 13 * * 1"

agentId
integer
required
Example:

123

description
string | null
enabled
boolean
default:true

Response

Task created.

id
integer
Example:

42

name
string
Example:

"Weekly portfolio digest"

description
string | null
prompt
string
Example:

"Summarize any new documents added this week."

schedule
string

Cron expression (UTC).

Example:

"0 13 * * 1"

enabled
boolean
agentId
integer
Example:

123

agentName
string

Present on list/get responses.

Example:

"Portfolio Monitor"

userId
string
lastRunAt
string<date-time> | null
createdAt
string<date-time>
updatedAt
string<date-time>