Skip to main content
GET
Retrieve a schedule
Returns the schedule object.

Path parameters

string
required
The schedule’s id (UUID).

The schedule object

string
Unique id (UUID).
string
Display name.
string | null
Optional description.
object
When the schedule fires: type ("cron"), expression (five-field cron), and timezone (IANA name the expression is evaluated in).
object
Template used to create each scheduled session, in the Create session body shape. Re-resolved on every fire.
boolean
Whether the schedule is paused. Paused schedules do not fire automatically but can still be triggered.
string | null
Why the schedule is paused: the note passed to Pause, or an explanatory note when it was paused automatically after repeated failures.
string[]
The next 5 fire times (UTC, RFC 3339). Empty while paused.
string | null
When the schedule last fired automatically. Manual triggers do not update it.
string
When the schedule was created.
string
When the schedule was last modified.

Examples

Response

Errors

Last modified on September 11, 2026