GET
/
api
/
deployments
/
{id}

Headers

x-prefect-api-version
string

Path Parameters

id
string
required

The deployment id

Response

200 - application/json
id
string
required
created
string | null
required
updated
string | null
required
name
string
required

The name of the deployment.

flow_id
string
required

The flow id associated with the deployment.

version
string | null

An optional version for the deployment.

description
string | null

A description for the deployment.

paused
boolean
default: false

Whether or not the deployment is paused.

schedules
object[]

A list of schedules for the deployment.

concurrency_limit
integer | null
deprecated

DEPRECATED: Prefer global_concurrency_limit. Will always be None for backwards compatibility. Will be removed after December 2024.

global_concurrency_limit
object | null

The global concurrency limit object for enforcing the maximum number of flow runs that can be active at once.

concurrency_options
object | null

The concurrency options for the deployment.

job_variables
object

Overrides to apply to the base infrastructure block at runtime.

parameters
object

Parameters for flow runs scheduled by the deployment.

tags
string[]

A list of tags for the deployment

labels
object

A dictionary of key-value labels. Values can be strings, numbers, or booleans.

work_queue_name
string | null

The work queue for the deployment. If no work queue is set, work will not be scheduled.

last_polled
string | null

The last time the deployment was polled for status updates.

parameter_openapi_schema
object | null

The parameter schema of the flow, including defaults.

path
string | null

The path to the working directory for the workflow, relative to remote storage or an absolute path.

pull_steps
object[] | null

Pull steps for cloning and running this deployment.

entrypoint
string | null

The path to the entrypoint for the workflow, relative to the path.

storage_document_id
string | null

The block document defining storage used for this flow.

infrastructure_document_id
string | null

The block document defining infrastructure to use for flow runs.

created_by
object | null

Optional information about the creator of this deployment.

updated_by
object | null

Optional information about the updater of this deployment.

work_pool_name
string | null

The name of the deployment's work pool.

status
enum<string> | null
default: NOT_READY

Whether the deployment is ready to run flows.

Available options:
READY,
NOT_READY
enforce_parameter_schema
boolean
default: true

Whether or not the deployment should enforce the parameter schema.