latestOpenAPI 3.1.02026-08-20118232229.3 KB

0e42b0fb26d9

Create schedule

Create a new schedule for an app.

post/schedules

Request body

$schemastring uri

A URL to the JSON Schema for this object.

app_namestring required

The name of the app to create a schedule for

app_versionstring nullable

This property is deprecated and ignored. Schedules inherit the version from their environment.

cronstring required

The cron expression defining when the app should run

environmentstring

The environment to run the app in

namestring nullable

The name for this schedule. Must be unique per environment. If not set, one will be generated for you.

overlap_policy'skip' | 'allow' nullable

The overlap policy for the schedule

status'active' | 'disabled' nullable

The status of the schedule (defaults to active)

timezonestring nullable

The IANA timezone identifier that the cron expression should be evaluated in (e.g., 'America/New_York', 'Europe/London'). Defaults to 'UTC'.

Example request

{
  "$schema": "https://api.tower.dev/v1/schemas/CreateScheduleParams.json"
}

Response

Created

$schemastring uri

A URL to the JSON Schema for this object.

Example response

{
  "$schema": "https://api.tower.dev/v1/schemas/CreateScheduleResponse.json"
}