PATCH
/
api
/
deployments
/
{id}
This response does not have an example.

Headers

​
x-prefect-api-version
string

Path Parameters

​
id
string<uuid>
required

The deployment id

Body

application/json

Data used by the Prefect REST API to update a deployment.

​
version
string | null
​
description
string | null
​
paused
boolean
default:false

Whether or not the deployment is paused.

​
schedules
DeploymentScheduleUpdate · object[]

A list of schedules for the deployment.

​
concurrency_limit
integer | null

The deployment's concurrency limit.

Required range: x > 0
​
concurrency_options
object | null

The deployment's concurrency options. Class for storing the concurrency config in database.

​
global_concurrency_limit_id
string<uuid> | null

The ID of the global concurrency limit to apply to the deployment.

​
parameters
object | null

Parameters for flow runs scheduled by the deployment.

​
parameter_openapi_schema
object | null

The parameter schema of the flow, including defaults.

​
tags
string[]

A list of deployment tags.

Examples:
["tag-1", "tag-2"]
​
work_queue_name
string | null
​
work_pool_name
string | null

The name of the deployment's work pool.

Examples:

"my-work-pool"

​
path
string | null
​
job_variables
object | null

Overrides for the flow's infrastructure configuration.

​
pull_steps
Pull Steps · object[] | null
​
entrypoint
string | null
​
storage_document_id
string<uuid> | null
​
infrastructure_document_id
string<uuid> | null
​
enforce_parameter_schema
boolean | null

Whether or not the deployment should enforce the parameter schema.

​
version_info
object | null

A description of this version of the deployment.

Response

Successful Response