Sign in

v50

latestOpenAPI 3.1.0raw.githubusercontent.com2025-01-16170291390.7 KB
Deployments

Create Deployment Schedules

post/api/deployments/{id}/schedules

Path parameters

idstring uuid required

The deployment id

The deployment id

Headers

x-prefect-api-versionstring

Request body

activeboolean

Whether or not the schedule is active.

max_active_runsinteger

The maximum number of active runs for the schedule.

max_scheduled_runsinteger

The maximum number of scheduled runs for the schedule.

catchupboolean

Whether or not a worker should catch up on Late runs for the schedule.

Example request

[
  {
    "schedule": {
      "timezone": "America/New_York"
    }
  }
]

Response

Successful Response

idstring uuid
createdstring date-time
updatedstring date-time
deployment_idstring uuid

The deployment id associated with this schedule.

activeboolean

Whether or not the schedule is active.

max_active_runsinteger

The maximum number of active runs for the schedule.

max_scheduled_runsinteger

The maximum number of scheduled runs for the schedule.

catchupboolean

Whether or not a worker should catch up on Late runs for the schedule.

Example response

[
  {
    "schedule": {
      "timezone": "America/New_York"
    }
  }
]