Sign in

v50

latestOpenAPI 3.1.0raw.githubusercontent.com2025-01-16170291390.7 KB
Flow Run Notification Policies

Create Flow Run Notification Policy

Creates a new flow run notification policy.

post/api/flow_run_notification_policies/

Headers

x-prefect-api-versionstring

Request body

is_activeboolean

Whether the policy is currently active

state_namesstring[] required

The flow run states that trigger notifications

tagsstring[] required

The flow run tags that trigger notifications (set [] to disable)

block_document_idstring uuid required

The block document ID used for sending notifications

message_templatestring

A templatable notification message. Use {braces} to add variables. Valid variables include: 'flow_id', 'flow_name', 'flow_run_id', 'flow_run_name', 'flow_run_notification_policy_id', 'flow_run_parameters', 'flow_run_state_message', 'flow_run_state_name', 'flow_run_state_timestamp', 'flow_run_state_type', 'flow_run_url'

Example request

{
  "message_template": "Flow run {flow_run_name} with id {flow_run_id} entered state {flow_run_state_name}."
}

Response

Successful Response

idstring uuid
createdstring date-time
updatedstring date-time
is_activeboolean

Whether the policy is currently active

state_namesstring[] required

The flow run states that trigger notifications

tagsstring[] required

The flow run tags that trigger notifications (set [] to disable)

block_document_idstring uuid required

The block document ID used for sending notifications

message_templatestring

A templatable notification message. Use {braces} to add variables. Valid variables include: 'flow_id', 'flow_name', 'flow_run_id', 'flow_run_name', 'flow_run_notification_policy_id', 'flow_run_parameters', 'flow_run_state_message', 'flow_run_state_name', 'flow_run_state_timestamp', 'flow_run_state_type', 'flow_run_url'

Example response

{
  "message_template": "Flow run {flow_run_name} with id {flow_run_id} entered state {flow_run_state_name}."
}