list_schedules
The organization’s scheduled runs, each with its cadence in words and its next fire times.
Parameters#
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
target_type | string | null | no | Filter by assistant, workflow or batch_job | |
status | string | null | no | Filter by active or paused | |
limit | integer | no | 50 | Max schedules to return (capped at 200) |
Returns#
json
{
"schedules": [
{
"schedule_id": "sched_abc123",
"name": "Morning pacing check",
"cron_expression": "0 7 * * 1-5",
"timezone": "America/Los_Angeles",
"human_readable": "Every weekday at 7:00 AM (America/Los_Angeles)",
"next_runs": ["2026-08-19T07:00:00-07:00"],
"status": "active",
"target_type": "assistant",
"target_name": "Pacing analyst"
}
]
}Errors#
error_type | When |
|---|---|
auth_error | Missing / invalid API key |