--- title: Update a Notification policy --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) [Alerting](https://developers.cloudflare.com/api/python/resources/alerting) [Policies](https://developers.cloudflare.com/api/python/resources/alerting/subresources/policies) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Update a Notification policy alerting.policies.update(strpolicy\_id, PolicyUpdateParams\*\*kwargs) -> [PolicyUpdateResponse]() 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` ##### ParametersExpand Collapse account\_id: str 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: str 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)>) alert\_interval: Optional\[str] 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)%20default%20%3E%20(param)%20alert_interval%20%3E%20(schema)>)
alert\_type: Optional\[Literal\["abuse\_report\_alert", "access\_custom\_certificate\_expiration\_type", "advanced\_ddos\_attack\_l4\_alert", 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)%20default%20%3E%20(param)%20alert_type%20%3E%20(schema)>) description: Optional\[str] Optional description for the Notification policy. [Link to this property](<#(resource)%20alerting.policies%20%3E%20(method)%20update%20%3E%20(params)%20default%20%3E%20(param)%20description%20%3E%20(schema)>) enabled: Optional\[[bool]()] Whether or not the Notification policy is enabled. [Link to this property](<#(resource)%20alerting.policies%20%3E%20(method)%20update%20%3E%20(params)%20default%20%3E%20(param)%20enabled%20%3E%20(schema)>)
filters: Optional\[PolicyFilterParam] 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\[List\[str]] Usage depends on specific alert type Link to this property affected\_asns: Optional\[List\[str]] Used for configuring radar\_notification Link to this property affected\_components: Optional\[List\[str]] Used for configuring incident\_alert Link to this property affected\_locations: Optional\[List\[str]] Used for configuring radar\_notification Link to this property airport\_code: Optional\[List\[str]] Used for configuring maintenance\_event\_notification Link to this property alert\_trigger\_preferences: Optional\[List\[str]] Usage depends on specific alert type Link to this property alert\_trigger\_preferences\_value: Optional\[List\[str]] Usage depends on specific alert type Link to this property enabled: Optional\[List\[str]] Used for configuring load\_balancing\_pool\_enablement\_alert Link to this property environment: Optional\[List\[str]] Used for configuring pages\_event\_alert Link to this property event: Optional\[List\[str]] Used for configuring pages\_event\_alert Link to this property event\_source: Optional\[List\[str]] Used for configuring load\_balancing\_health\_alert Link to this property event\_type: Optional\[List\[str]] Usage depends on specific alert type Link to this property group\_by: Optional\[List\[str]] Usage depends on specific alert type Link to this property health\_check\_id: Optional\[List\[str]] Used for configuring health\_check\_status\_notification Link to this property
incident\_impact: Optional\[List\[Literal\["INCIDENT\_IMPACT\_NONE", "INCIDENT\_IMPACT\_MINOR", "INCIDENT\_IMPACT\_MAJOR", "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\[List\[str]] Used for configuring stream\_live\_notifications Link to this property insight\_class: Optional\[List\[str]] Used for configuring security\_insights\_alert Link to this property limit: Optional\[List\[str]] Used for configuring billing\_usage\_alert Link to this property logo\_tag: Optional\[List\[str]] Used for configuring logo\_match\_alert Link to this property megabits\_per\_second: Optional\[List\[str]] Used for configuring advanced\_ddos\_attack\_l4\_alert Link to this property new\_health: Optional\[List\[str]] Used for configuring load\_balancing\_health\_alert Link to this property new\_status: Optional\[List\[str]] Used for configuring tunnel\_health\_event Link to this property packets\_per\_second: Optional\[List\[str]] Used for configuring advanced\_ddos\_attack\_l4\_alert Link to this property pool\_id: Optional\[List\[str]] Usage depends on specific alert type Link to this property pop\_names: Optional\[List\[str]] Usage depends on specific alert type Link to this property product: Optional\[List\[str]] Used for configuring billing\_usage\_alert Link to this property project\_id: Optional\[List\[str]] Used for configuring pages\_event\_alert Link to this property protocol: Optional\[List\[str]] Used for configuring advanced\_ddos\_attack\_l4\_alert Link to this property query\_tag: Optional\[List\[str]] Usage depends on specific alert type Link to this property requests\_per\_second: Optional\[List\[str]] Used for configuring advanced\_ddos\_attack\_l7\_alert Link to this property selectors: Optional\[List\[str]] Usage depends on specific alert type Link to this property services: Optional\[List\[str]] Used for configuring clickhouse\_alert\_fw\_ent\_anomaly Link to this property slo: Optional\[List\[str]] Usage depends on specific alert type Link to this property status: Optional\[List\[str]] Used for configuring health\_check\_status\_notification Link to this property target\_hostname: Optional\[List\[str]] Used for configuring advanced\_ddos\_attack\_l7\_alert Link to this property target\_ip: Optional\[List\[str]] Used for configuring advanced\_ddos\_attack\_l4\_alert Link to this property target\_zone\_name: Optional\[List\[str]] Used for configuring advanced\_ddos\_attack\_l7\_alert Link to this property token\_id: Optional\[List\[str]] 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\[List\[Literal\["security\_events"]]] Used for configuring traffic\_anomalies\_alert Link to this property tunnel\_id: Optional\[List\[str]] Used for configuring tunnel\_health\_event Link to this property tunnel\_name: Optional\[List\[str]] Usage depends on specific alert type Link to this property type: Optional\[List\[str]] Usage depends on specific alert type Link to this property where: Optional\[List\[str]] Usage depends on specific alert type Link to this property zones: Optional\[List\[str]] 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)%20default%20%3E%20(param)%20filters%20%3E%20(schema)>)
mechanisms: Optional\[MechanismParam] List of IDs that will be used when dispatching a notification. IDs for email type will be the email address.
email: Optional\[List\[Email]] id: Optional\[str] The email address Link to this property
Link to this property
pagerduty: Optional\[List\[Pagerduty]] id: Optional\[str] UUID maxLength32 Link to this property
Link to this property
webhooks: Optional\[List\[Webhook]] id: Optional\[str] 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)%20default%20%3E%20(param)%20mechanisms%20%3E%20(schema)>) name: Optional\[str] Name of the policy. [Link to this property](<#(resource)%20alerting.policies%20%3E%20(method)%20update%20%3E%20(params)%20default%20%3E%20(param)%20name%20%3E%20(schema)>) ##### ReturnsExpand Collapse
class PolicyUpdateResponse: … id: Optional\[str] UUID maxLength32 Link to this property
[Link to this property](<#(resource)%20alerting.policies%20%3E%20(model)%20policy_update_response%20%3E%20(schema)>) ### Update a Notification policy Python HTTPTypeScriptPythonGoTerraform ``` import os from cloudflare import Cloudflare client = Cloudflare( api_token=os.environ.get("CLOUDFLARE_API_TOKEN"), # This is the default and can be omitted ) policy = client.alerting.policies.update( policy_id="0da2b59ef118439d8097bdfb215203c9", account_id="023e105f4ecef8ad9ca31a8372d0c353", ) print(policy.id) ``` 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" } } ```