Skip to main content
Deployment events track the lifecycle of deployments, including creation, updates, deletion, and status transitions. These events are emitted server-side. For more on deployments, see Deployments.

prefect.deployment.created

Emitted when a new deployment is created.

Resource

LabelDescription
prefect.resource.idprefect.deployment.{uuid}
prefect.resource.nameDeployment name
Resource ID patternRoleWhen present
prefect.flow.{uuid}flowAlways
prefect.work-queue.{uuid}work-queueWhen a work queue is assigned
prefect.work-pool.{uuid}work-poolWhen a work pool is assigned (includes prefect.work-pool.type label)

Payload

This event has no payload.

prefect.deployment.updated

Emitted when one or more deployment fields are changed.

Resource

LabelDescription
prefect.resource.idprefect.deployment.{uuid}
prefect.resource.nameDeployment name
Same as prefect.deployment.created.

Payload

FieldTypeDescription
updated_fieldsarray of stringsNames of fields that changed
updatesobjectMap of field name to {"from": <old>, "to": <new>}

prefect.deployment.deleted

Emitted when a deployment is deleted.

Resource

LabelDescription
prefect.resource.idprefect.deployment.{uuid}
prefect.resource.nameDeployment name
Same as prefect.deployment.created.

Payload

This event has no payload.

prefect.deployment.{status}

Emitted when a deployment’s readiness status changes. The {status} suffix is the kebab-case status value.

Status variants

Event nameDescription
prefect.deployment.readyDeployment is ready to create runs
prefect.deployment.not-readyDeployment is not ready (for example, no active schedule or no available work pool)

Resource

LabelDescription
prefect.resource.idprefect.deployment.{uuid}
prefect.resource.nameDeployment name
Same as prefect.deployment.created.

Payload

This event has no payload.