Deployment events

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

Label	Description
`prefect.resource.id`	`prefect.deployment.{uuid}`
`prefect.resource.name`	Deployment name

Resource ID pattern	Role	When present
`prefect.flow.{uuid}`	`flow`	Always
`prefect.work-queue.{uuid}`	`work-queue`	When a work queue is assigned
`prefect.work-pool.{uuid}`	`work-pool`	When a work pool is assigned (includes `prefect.work-pool.type` label)
`prefect.block-document.{uuid}`	`storage`	When a storage block document is configured
`prefect.block-document.{uuid}`	`infrastructure`	When an infrastructure block document is configured
`prefect.concurrency-limit.{uuid}`	`concurrency-limit`	When a concurrency limit is assigned

Payload

This event has no payload.

`prefect.deployment.updated`

Emitted when one or more deployment fields are changed.

Resource

Label	Description
`prefect.resource.id`	`prefect.deployment.{uuid}`
`prefect.resource.name`	Deployment name

Same as prefect.deployment.created.

Payload

Field	Type	Description
`updated_fields`	array of strings	Names of fields that changed
`updates`	object	Map of field name to `{"from": <old>, "to": <new>}`

Show Example: deployment schedule updated

{
  "occurred": "2026-03-31T18:30:00.000000Z",
  "event": "prefect.deployment.updated",
  "resource": {
    "prefect.resource.id": "prefect.deployment.b2c3d4e5-f6a7-8901-bcde-f12345678901",
    "prefect.resource.name": "my-etl-flow/production"
  },
  "related": [
    {
      "prefect.resource.id": "prefect.flow.a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "prefect.resource.name": "my-etl-flow",
      "prefect.resource.role": "flow"
    }
  ],
  "payload": {
    "updated_fields": ["is_schedule_active"],
    "updates": {
      "is_schedule_active": {
        "from": true,
        "to": false
      }
    }
  },
  "id": "c3d4e5f6-a7b8-9012-cdef-123456789012"
}

`prefect.deployment.deleted`

Emitted when a deployment is deleted.

Resource

Label	Description
`prefect.resource.id`	`prefect.deployment.{uuid}`
`prefect.resource.name`	Deployment 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 name	Description
`prefect.deployment.ready`	Deployment is ready to create runs
`prefect.deployment.not-ready`	Deployment is not ready (for example, no active schedule or no available work pool)

Resource

Label	Description
`prefect.resource.id`	`prefect.deployment.{uuid}`
`prefect.resource.name`	Deployment name

Same as prefect.deployment.created.

Payload

This event has no payload.

​prefect.deployment.created

​Resource

​Related resources

​Payload

​prefect.deployment.updated

​Resource

​Related resources

​Payload

​prefect.deployment.deleted

​Resource

​Related resources

​Payload

​prefect.deployment.{status}

​Status variants

​Resource

​Related resources

​Payload

`prefect.deployment.created`

Resource

Related resources

Payload

`prefect.deployment.updated`

Resource

Related resources

Payload

`prefect.deployment.deleted`

Resource

Related resources

Payload

`prefect.deployment.{status}`

Status variants

Resource

Related resources

Payload