Automation events

Automation events cover two categories: CRUD lifecycle events emitted when automations are created, updated, or deleted, and trigger lifecycle events emitted when an automation fires and executes actions. For more on automations, see Automations.

​

Automation lifecycle events

​

prefect.automation.created

Emitted when a new automation is created.

​

Resource

​

Related resources

This event has no related resources.

​

Payload

The full automation serialized as JSON, including id, name, description, enabled, trigger, actions, actions_on_trigger, and actions_on_resolve.

​

prefect.automation.updated

Emitted when an automation is updated.

​

Resource

Same as prefect.automation.created.

​

Related resources

This event has no related resources.

​

Payload

Same as prefect.automation.created.

​

prefect.automation.deleted

Emitted when an automation is deleted.

​

Resource

Same as prefect.automation.created.

​

Related resources

This event has no related resources.

​

Payload

Same as prefect.automation.created.

​

Trigger state events

​

prefect.automation.triggered

Emitted when an automation’s trigger condition is met and the automation enters the triggered state.

​

Resource

​

Related resources

​

Payload

​

prefect.automation.resolved

Emitted when an automation’s trigger condition is no longer met and the automation returns to the resolved state (for example, a proactive trigger that previously fired because events stopped now sees events resume).

​

Resource

Same as prefect.automation.triggered.

​

Related resources

Same as prefect.automation.triggered.

​

Payload

Same as prefect.automation.triggered.

​

Action lifecycle events

​

prefect.automation.action.triggered

Emitted when an automation action begins execution.

​

Resource

​

Related resources

​

Payload

​

prefect.automation.action.executed

Emitted when an automation action completes successfully. Uses the follows field to link back to the corresponding action.triggered event.

​

Resource

Same as prefect.automation.action.triggered.

​

Related resources

Same as prefect.automation.action.triggered.

​

Payload

Additional fields vary by action type and include details about the action’s result (for example, the flow run ID created by a run-deployment action).

​

prefect.automation.action.failed

Emitted when an automation action fails. Uses the follows field to link back to the corresponding action.triggered event.

​

Resource

Same as prefect.automation.action.triggered.

​

Related resources

Same as prefect.automation.action.triggered.

​

Payload

​

Prefect Cloud automation events

Prefect Cloud emits its own automation events using the prefect-cloud namespace. These are structurally identical to the OSS events above but use different event names.

​

prefect-cloud.automation.triggered

Cloud equivalent of prefect.automation.triggered. Emitted when an automation enters the triggered state.

​

prefect-cloud.automation.resolved

Cloud equivalent of prefect.automation.resolved. Emitted when an automation returns to the resolved state.

​

prefect-cloud.automation.action.triggered

Cloud equivalent of prefect.automation.action.triggered.

​

prefect-cloud.automation.action.executed

Cloud equivalent of prefect.automation.action.executed.

​

prefect-cloud.automation.action.failed

Cloud equivalent of prefect.automation.action.failed.

​

prefect-cloud.automation.action.disabled

Emitted when an automation action is disabled (for example, after repeated failures). This event is specific to Prefect Cloud.