--- title: Update a Notification policy --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api) [Alerting](https://developers.cloudflare.com/api/resources/alerting) [Policies](https://developers.cloudflare.com/api/resources/alerting/subresources/policies) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Update a Notification policy PUT/accounts/{account\_id}/alerting/v3/policies/{policy\_id} Update a Notification policy. ##### Security
API Token The preferred authorization scheme for interacting with the Cloudflare API. Create a token. **Example:**Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY
API Email + API Key The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key. **Example:**X-Auth-Email: user@example.com The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys. **Example:**X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194
##### Accepted Permissions (at least one required) `Notifications Write``Account Settings Write` ##### P ath ParametersExpand Collapse account\_id: string The account id maxLength32 [Link to this property](<#(resource)%20alerting.policies%20%3E%20(method)%20update%20%3E%20(params)%20default%20%3E%20(param)%20account_id%20%3E%20(schema)>) policy\_id: string The unique identifier of a notification policy maxLength32 [Link to this property](<#(resource)%20alerting.policies%20%3E%20(method)%20update%20%3E%20(params)%20default%20%3E%20(param)%20policy_id%20%3E%20(schema)>) ##### Body ParametersJSONExpand Collapse alert\_interval: optional string Optional specification of how often to re-alert from the same incident, not support on all alert types. [Link to this property](<#(resource)%20alerting.policies%20%3E%20(method)%20update%20%3E%20(params)%200%20%3E%20(param)%20alert_interval%20%3E%20(schema)>)
alert\_type: optional "abuse\_report\_alert"or "access\_custom\_certificate\_expiration\_type"or "advanced\_ddos\_attack\_l4\_alert"or 66 more Refers to which event will trigger a Notification dispatch. You can use the endpoint to get available alert types which then will give you a list of possible values. One of the following: "abuse\_report\_alert" Link to this property "access\_custom\_certificate\_expiration\_type" Link to this property "advanced\_ddos\_attack\_l4\_alert" Link to this property "advanced\_ddos\_attack\_l7\_alert" Link to this property "advanced\_http\_alert\_error" Link to this property "bgp\_hijack\_notification" Link to this property "billing\_usage\_alert" Link to this property "block\_notification\_block\_removed" Link to this property "block\_notification\_new\_block" Link to this property "block\_notification\_review\_rejected" Link to this property "bot\_traffic\_basic\_alert" Link to this property "brand\_protection\_alert" Link to this property "brand\_protection\_digest" Link to this property "clickhouse\_alert\_fw\_anomaly" Link to this property "clickhouse\_alert\_fw\_ent\_anomaly" Link to this property "cloudforce\_one\_request\_notification" Link to this property "cni\_maintenance\_notification" Link to this property "custom\_analytics" Link to this property "custom\_bot\_detection\_alert" Link to this property "custom\_ssl\_certificate\_event\_type" Link to this property "dedicated\_ssl\_certificate\_event\_type" Link to this property "device\_connectivity\_anomaly\_alert" Link to this property "dos\_attack\_l4" Link to this property "dos\_attack\_l7" Link to this property "expiring\_service\_token\_alert" Link to this property "failing\_logpush\_job\_disabled\_alert" Link to this property "fbm\_auto\_advertisement" Link to this property "fbm\_dosd\_attack" Link to this property "fbm\_volumetric\_attack" Link to this property "health\_check\_status\_notification" Link to this property "hostname\_aop\_custom\_certificate\_expiration\_type" Link to this property "http\_alert\_edge\_error" Link to this property "http\_alert\_origin\_error" Link to this property "image\_notification" Link to this property "image\_resizing\_notification" Link to this property "incident\_alert" Link to this property "load\_balancing\_health\_alert" Link to this property "load\_balancing\_pool\_enablement\_alert" Link to this property "logo\_match\_alert" Link to this property "magic\_tunnel\_health\_check\_event" Link to this property "magic\_wan\_tunnel\_health" Link to this property "maintenance\_event\_notification" Link to this property "mtls\_certificate\_store\_certificate\_expiration\_type" Link to this property "pages\_event\_alert" Link to this property "radar\_notification" Link to this property "real\_origin\_monitoring" Link to this property "scriptmonitor\_alert\_new\_code\_change\_detections" Link to this property "scriptmonitor\_alert\_new\_hosts" Link to this property "scriptmonitor\_alert\_new\_malicious\_hosts" Link to this property "scriptmonitor\_alert\_new\_malicious\_scripts" Link to this property "scriptmonitor\_alert\_new\_malicious\_url" Link to this property "scriptmonitor\_alert\_new\_max\_length\_resource\_url" Link to this property "scriptmonitor\_alert\_new\_resources" Link to this property "secondary\_dns\_all\_primaries\_failing" Link to this property "secondary\_dns\_primaries\_failing" Link to this property "secondary\_dns\_warning" Link to this property "secondary\_dns\_zone\_successfully\_updated" Link to this property "secondary\_dns\_zone\_validation\_warning" Link to this property "security\_insights\_alert" Link to this property "sentinel\_alert" Link to this property "stream\_live\_notifications" Link to this property "synthetic\_test\_latency\_alert" Link to this property "synthetic\_test\_low\_availability\_alert" Link to this property "traffic\_anomalies\_alert" Link to this property "tunnel\_health\_event" Link to this property "tunnel\_update\_event" Link to this property "universal\_ssl\_event\_type" Link to this property "web\_analytics\_metrics\_update" Link to this property "zone\_aop\_custom\_certificate\_expiration\_type" Link to this property
[Link to this property](<#(resource)%20alerting.policies%20%3E%20(method)%20update%20%3E%20(params)%200%20%3E%20(param)%20alert_type%20%3E%20(schema)>) description: optional string Optional description for the Notification policy. [Link to this property](<#(resource)%20alerting.policies%20%3E%20(method)%20update%20%3E%20(params)%200%20%3E%20(param)%20description%20%3E%20(schema)>) enabled: optional boolean Whether or not the Notification policy is enabled. [Link to this property](<#(resource)%20alerting.policies%20%3E%20(method)%20update%20%3E%20(params)%200%20%3E%20(param)%20enabled%20%3E%20(schema)>)
filters: optional PolicyFilter { actions, affected\_asns, affected\_components, 41 more } Optional filters that allow you to be alerted only on a subset of events for that alert type based on some criteria. This is only available for select alert types. See alert type documentation for more details. actions: optional array of string Usage depends on specific alert type Link to this property affected\_asns: optional array of string Used for configuring radar\_notification Link to this property affected\_components: optional array of string Used for configuring incident\_alert Link to this property affected\_locations: optional array of string Used for configuring radar\_notification Link to this property airport\_code: optional array of string Used for configuring maintenance\_event\_notification Link to this property alert\_trigger\_preferences: optional array of string Usage depends on specific alert type Link to this property alert\_trigger\_preferences\_value: optional array of string Usage depends on specific alert type Link to this property enabled: optional array of string Used for configuring load\_balancing\_pool\_enablement\_alert Link to this property environment: optional array of string Used for configuring pages\_event\_alert Link to this property event: optional array of string Used for configuring pages\_event\_alert Link to this property event\_source: optional array of string Used for configuring load\_balancing\_health\_alert Link to this property event\_type: optional array of string Usage depends on specific alert type Link to this property group\_by: optional array of string Usage depends on specific alert type Link to this property health\_check\_id: optional array of string Used for configuring health\_check\_status\_notification Link to this property
incident\_impact: optional array of "INCIDENT\_IMPACT\_NONE"or "INCIDENT\_IMPACT\_MINOR"or "INCIDENT\_IMPACT\_MAJOR"or "INCIDENT\_IMPACT\_CRITICAL" Used for configuring incident\_alert One of the following: "INCIDENT\_IMPACT\_NONE" Link to this property "INCIDENT\_IMPACT\_MINOR" Link to this property "INCIDENT\_IMPACT\_MAJOR" Link to this property "INCIDENT\_IMPACT\_CRITICAL" Link to this property
Link to this property input\_id: optional array of string Used for configuring stream\_live\_notifications Link to this property insight\_class: optional array of string Used for configuring security\_insights\_alert Link to this property limit: optional array of string Used for configuring billing\_usage\_alert Link to this property logo\_tag: optional array of string Used for configuring logo\_match\_alert Link to this property megabits\_per\_second: optional array of string Used for configuring advanced\_ddos\_attack\_l4\_alert Link to this property new\_health: optional array of string Used for configuring load\_balancing\_health\_alert Link to this property new\_status: optional array of string Used for configuring tunnel\_health\_event Link to this property packets\_per\_second: optional array of string Used for configuring advanced\_ddos\_attack\_l4\_alert Link to this property pool\_id: optional array of string Usage depends on specific alert type Link to this property pop\_names: optional array of string Usage depends on specific alert type Link to this property product: optional array of string Used for configuring billing\_usage\_alert Link to this property project\_id: optional array of string Used for configuring pages\_event\_alert Link to this property protocol: optional array of string Used for configuring advanced\_ddos\_attack\_l4\_alert Link to this property query\_tag: optional array of string Usage depends on specific alert type Link to this property requests\_per\_second: optional array of string Used for configuring advanced\_ddos\_attack\_l7\_alert Link to this property selectors: optional array of string Usage depends on specific alert type Link to this property services: optional array of string Used for configuring clickhouse\_alert\_fw\_ent\_anomaly Link to this property slo: optional array of string Usage depends on specific alert type Link to this property status: optional array of string Used for configuring health\_check\_status\_notification Link to this property target\_hostname: optional array of string Used for configuring advanced\_ddos\_attack\_l7\_alert Link to this property target\_ip: optional array of string Used for configuring advanced\_ddos\_attack\_l4\_alert Link to this property target\_zone\_name: optional array of string Used for configuring advanced\_ddos\_attack\_l7\_alert Link to this property token\_id: optional array of string Access service token IDs to include for expiring\_service\_token\_alert. Omit this property to include all current and future service tokens. Link to this property traffic\_exclusions: optional array of "security\_events" Used for configuring traffic\_anomalies\_alert Link to this property tunnel\_id: optional array of string Used for configuring tunnel\_health\_event Link to this property tunnel\_name: optional array of string Usage depends on specific alert type Link to this property type: optional array of string Usage depends on specific alert type Link to this property where: optional array of string Usage depends on specific alert type Link to this property zones: optional array of string Usage depends on specific alert type Link to this property
[Link to this property](<#(resource)%20alerting.policies%20%3E%20(method)%20update%20%3E%20(params)%200%20%3E%20(param)%20filters%20%3E%20(schema)>)
mechanisms: optional Mechanism { email, pagerduty, webhooks } List of IDs that will be used when dispatching a notification. IDs for email type will be the email address.
email: optional array of object {id } id: optional string The email address Link to this property
Link to this property
pagerduty: optional array of object {id } id: optional string UUID maxLength32 Link to this property
Link to this property
webhooks: optional array of object {id } id: optional string UUID maxLength32 Link to this property
Link to this property
[Link to this property](<#(resource)%20alerting.policies%20%3E%20(method)%20update%20%3E%20(params)%200%20%3E%20(param)%20mechanisms%20%3E%20(schema)>) name: optional string Name of the policy. [Link to this property](<#(resource)%20alerting.policies%20%3E%20(method)%20update%20%3E%20(params)%200%20%3E%20(param)%20name%20%3E%20(schema)>) ##### ReturnsExpand Collapse
errors: array of object {message, code } message: string Link to this property code: optional number minimum1000 Link to this property
[Link to this property](<#(resource)%20alerting.policies%20%3E%20(method)%20update%20%3E%20(network%20schema)%20%3E%20(property)%20errors>)
messages: array of object {message, code } message: string Link to this property code: optional number minimum1000 Link to this property
[Link to this property](<#(resource)%20alerting.policies%20%3E%20(method)%20update%20%3E%20(network%20schema)%20%3E%20(property)%20messages>) success: true Whether the API call was successful [Link to this property](<#(resource)%20alerting.policies%20%3E%20(method)%20update%20%3E%20(network%20schema)%20%3E%20(property)%20success>)
result: optional object {id } id: optional string UUID maxLength32 Link to this property
[Link to this property](<#(resource)%20alerting.policies%20%3E%20(method)%20update%20%3E%20(network%20schema)%20%3E%20(property)%20result>) ### Update a Notification policy HTTP HTTPTypeScriptPythonGoTerraform ``` curl https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/alerting/v3/policies/$POLICY_ID \ -X PUT \ -H 'Content-Type: application/json' \ -H "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \ -d '{ "alert_interval": "30m", "alert_type": "universal_ssl_event_type", "description": "Something describing the policy.", "enabled": true, "filters": { "slo": [ "99.9" ] }, "name": "SSL Notification Event Policy" }' ``` 200 example ``` { "errors": [ { "message": "message", "code": 1000 } ], "messages": [ { "message": "message", "code": 1000 } ], "success": true, "result": { "id": "f174e90afafe4643bbbc4a0ed4fc8415" } } ``` ##### Returns Examples 200 example ``` { "errors": [ { "message": "message", "code": 1000 } ], "messages": [ { "message": "message", "code": 1000 } ], "success": true, "result": { "id": "f174e90afafe4643bbbc4a0ed4fc8415" } } ```