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 Bodyrequired
Section titled “Request Bodyrequired”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/Londonparams
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