Skip to main content
GET
List Scheduled Tasks
Returns the recurring scheduled tasks configured on an agent. A scheduled task runs the agent on a cron schedule with a fixed prompt.

Response

array
Array of scheduled tasks.

Example Request

Example Response

Authorizations

x-api-key
string
header
required

API Key for authentication

Path Parameters

agent_id
string
required

Response

Successful Response

id
string
required

Source-node id. Pass it to update/remove/run the task.

cron
string
required

Cron expression (5-field crontab, UTC), e.g. '0 9 * * *'.

prompt
string
required

Instruction the agent runs on each fire.

title
string | null

Human-readable label for the task.

enabled
boolean
default:true

Whether the task is active. Disabled tasks keep their config but do not fire.