Create a schedule for a job
POST
/jobs/{jobId}/schedules
Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ” jobId
required
string
Job definition ID
Query Parameters
Section titled “Query Parameters ” workspaceId
required
string
Workspace ID
Request Body required
Section titled “Request Body required ”object
job_id
required
ID of the job definition to schedule
string
cron_expression
required
Cron expression (5-field, UTC). E.g. “0 2 * * *” for daily at 02:00 UTC
string
Example
0 2 * * * timezone
IANA timezone for interpreting the cron expression (defaults to UTC)
string
Example
Europe/London params
Runtime parameters forwarded on each scheduled run
object
enabled
Whether the schedule is active upon creation (default true)
boolean
Responses
Section titled “ Responses ”Schedule created
object
schedule_id
required
Unique identifier for the schedule
string
job_id
required
ID of the scheduled job definition
string
cron_expression
required
The cron expression (5-field, UTC)
string
timezone
IANA timezone
string
enabled
required
Whether the schedule is active
boolean
next_run_at
ISO-8601 timestamp of the next predicted run
string
created_at
required
ISO-8601 timestamp when the schedule was created
string
WorkspaceId is required