Skip to main content
GET
List scheduled tasks (or get one)

Authorizations

Authorization
string
header
required

JWT token from Clerk authentication.

Must be from a user with org:admin role.

Query Parameters

taskId
integer

Return a single task by id instead of the list.

allInOrg
boolean

Admins only — list all tasks in the org rather than just the caller's.

Response

A list of tasks (or a single task when taskId is given).

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>