--- title: Update a Notification policy --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/go) [Alerting](https://developers.cloudflare.com/api/go/resources/alerting) [Policies](https://developers.cloudflare.com/api/go/resources/alerting/subresources/policies) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Update a Notification policy client.Alerting.Policies.Update(ctx, policyID, params) (\*[PolicyUpdateResponse](), error) 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 policyID 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)>)
params PolicyUpdateParams AccountID param.Field\[string] Path param: The account id maxLength32 Link to this property AlertInterval param.Field\[string]Optional Body param: Optional specification of how often to re-alert from the same incident, not support on all alert types. Link to this property
AlertType param.Field\[PolicyUpdateParamsAlertType]Optional Body param: 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. const PolicyUpdateParamsAlertTypeAbuseReportAlert PolicyUpdateParamsAlertType = "abuse\_report\_alert" Link to this property const PolicyUpdateParamsAlertTypeAccessCustomCertificateExpirationType PolicyUpdateParamsAlertType = "access\_custom\_certificate\_expiration\_type" Link to this property const PolicyUpdateParamsAlertTypeAdvancedDDoSAttackL4Alert PolicyUpdateParamsAlertType = "advanced\_ddos\_attack\_l4\_alert" Link to this property const PolicyUpdateParamsAlertTypeAdvancedDDoSAttackL7Alert PolicyUpdateParamsAlertType = "advanced\_ddos\_attack\_l7\_alert" Link to this property const PolicyUpdateParamsAlertTypeAdvancedHTTPAlertError PolicyUpdateParamsAlertType = "advanced\_http\_alert\_error" Link to this property const PolicyUpdateParamsAlertTypeBGPHijackNotification PolicyUpdateParamsAlertType = "bgp\_hijack\_notification" Link to this property const PolicyUpdateParamsAlertTypeBillingUsageAlert PolicyUpdateParamsAlertType = "billing\_usage\_alert" Link to this property const PolicyUpdateParamsAlertTypeBlockNotificationBlockRemoved PolicyUpdateParamsAlertType = "block\_notification\_block\_removed" Link to this property const PolicyUpdateParamsAlertTypeBlockNotificationNewBlock PolicyUpdateParamsAlertType = "block\_notification\_new\_block" Link to this property const PolicyUpdateParamsAlertTypeBlockNotificationReviewRejected PolicyUpdateParamsAlertType = "block\_notification\_review\_rejected" Link to this property const PolicyUpdateParamsAlertTypeBotTrafficBasicAlert PolicyUpdateParamsAlertType = "bot\_traffic\_basic\_alert" Link to this property const PolicyUpdateParamsAlertTypeBrandProtectionAlert PolicyUpdateParamsAlertType = "brand\_protection\_alert" Link to this property const PolicyUpdateParamsAlertTypeBrandProtectionDigest PolicyUpdateParamsAlertType = "brand\_protection\_digest" Link to this property const PolicyUpdateParamsAlertTypeClickhouseAlertFwAnomaly PolicyUpdateParamsAlertType = "clickhouse\_alert\_fw\_anomaly" Link to this property const PolicyUpdateParamsAlertTypeClickhouseAlertFwEntAnomaly PolicyUpdateParamsAlertType = "clickhouse\_alert\_fw\_ent\_anomaly" Link to this property const PolicyUpdateParamsAlertTypeCloudforceOneRequestNotification PolicyUpdateParamsAlertType = "cloudforce\_one\_request\_notification" Link to this property const PolicyUpdateParamsAlertTypeCNIMaintenanceNotification PolicyUpdateParamsAlertType = "cni\_maintenance\_notification" Link to this property const PolicyUpdateParamsAlertTypeCustomAnalytics PolicyUpdateParamsAlertType = "custom\_analytics" Link to this property const PolicyUpdateParamsAlertTypeCustomBotDetectionAlert PolicyUpdateParamsAlertType = "custom\_bot\_detection\_alert" Link to this property const PolicyUpdateParamsAlertTypeCustomSSLCertificateEventType PolicyUpdateParamsAlertType = "custom\_ssl\_certificate\_event\_type" Link to this property const PolicyUpdateParamsAlertTypeDedicatedSSLCertificateEventType PolicyUpdateParamsAlertType = "dedicated\_ssl\_certificate\_event\_type" Link to this property const PolicyUpdateParamsAlertTypeDeviceConnectivityAnomalyAlert PolicyUpdateParamsAlertType = "device\_connectivity\_anomaly\_alert" Link to this property const PolicyUpdateParamsAlertTypeDosAttackL4 PolicyUpdateParamsAlertType = "dos\_attack\_l4" Link to this property const PolicyUpdateParamsAlertTypeDosAttackL7 PolicyUpdateParamsAlertType = "dos\_attack\_l7" Link to this property const PolicyUpdateParamsAlertTypeExpiringServiceTokenAlert PolicyUpdateParamsAlertType = "expiring\_service\_token\_alert" Link to this property const PolicyUpdateParamsAlertTypeFailingLogpushJobDisabledAlert PolicyUpdateParamsAlertType = "failing\_logpush\_job\_disabled\_alert" Link to this property const PolicyUpdateParamsAlertTypeFbmAutoAdvertisement PolicyUpdateParamsAlertType = "fbm\_auto\_advertisement" Link to this property const PolicyUpdateParamsAlertTypeFbmDosdAttack PolicyUpdateParamsAlertType = "fbm\_dosd\_attack" Link to this property const PolicyUpdateParamsAlertTypeFbmVolumetricAttack PolicyUpdateParamsAlertType = "fbm\_volumetric\_attack" Link to this property const PolicyUpdateParamsAlertTypeHealthCheckStatusNotification PolicyUpdateParamsAlertType = "health\_check\_status\_notification" Link to this property const PolicyUpdateParamsAlertTypeHostnameAopCustomCertificateExpirationType PolicyUpdateParamsAlertType = "hostname\_aop\_custom\_certificate\_expiration\_type" Link to this property const PolicyUpdateParamsAlertTypeHTTPAlertEdgeError PolicyUpdateParamsAlertType = "http\_alert\_edge\_error" Link to this property const PolicyUpdateParamsAlertTypeHTTPAlertOriginError PolicyUpdateParamsAlertType = "http\_alert\_origin\_error" Link to this property const PolicyUpdateParamsAlertTypeImageNotification PolicyUpdateParamsAlertType = "image\_notification" Link to this property const PolicyUpdateParamsAlertTypeImageResizingNotification PolicyUpdateParamsAlertType = "image\_resizing\_notification" Link to this property const PolicyUpdateParamsAlertTypeIncidentAlert PolicyUpdateParamsAlertType = "incident\_alert" Link to this property const PolicyUpdateParamsAlertTypeLoadBalancingHealthAlert PolicyUpdateParamsAlertType = "load\_balancing\_health\_alert" Link to this property const PolicyUpdateParamsAlertTypeLoadBalancingPoolEnablementAlert PolicyUpdateParamsAlertType = "load\_balancing\_pool\_enablement\_alert" Link to this property const PolicyUpdateParamsAlertTypeLogoMatchAlert PolicyUpdateParamsAlertType = "logo\_match\_alert" Link to this property const PolicyUpdateParamsAlertTypeMagicTunnelHealthCheckEvent PolicyUpdateParamsAlertType = "magic\_tunnel\_health\_check\_event" Link to this property const PolicyUpdateParamsAlertTypeMagicWANTunnelHealth PolicyUpdateParamsAlertType = "magic\_wan\_tunnel\_health" Link to this property const PolicyUpdateParamsAlertTypeMaintenanceEventNotification PolicyUpdateParamsAlertType = "maintenance\_event\_notification" Link to this property const PolicyUpdateParamsAlertTypeMTLSCertificateStoreCertificateExpirationType PolicyUpdateParamsAlertType = "mtls\_certificate\_store\_certificate\_expiration\_type" Link to this property const PolicyUpdateParamsAlertTypePagesEventAlert PolicyUpdateParamsAlertType = "pages\_event\_alert" Link to this property const PolicyUpdateParamsAlertTypeRadarNotification PolicyUpdateParamsAlertType = "radar\_notification" Link to this property const PolicyUpdateParamsAlertTypeRealOriginMonitoring PolicyUpdateParamsAlertType = "real\_origin\_monitoring" Link to this property const PolicyUpdateParamsAlertTypeScriptmonitorAlertNewCodeChangeDetections PolicyUpdateParamsAlertType = "scriptmonitor\_alert\_new\_code\_change\_detections" Link to this property const PolicyUpdateParamsAlertTypeScriptmonitorAlertNewHosts PolicyUpdateParamsAlertType = "scriptmonitor\_alert\_new\_hosts" Link to this property const PolicyUpdateParamsAlertTypeScriptmonitorAlertNewMaliciousHosts PolicyUpdateParamsAlertType = "scriptmonitor\_alert\_new\_malicious\_hosts" Link to this property const PolicyUpdateParamsAlertTypeScriptmonitorAlertNewMaliciousScripts PolicyUpdateParamsAlertType = "scriptmonitor\_alert\_new\_malicious\_scripts" Link to this property const PolicyUpdateParamsAlertTypeScriptmonitorAlertNewMaliciousURL PolicyUpdateParamsAlertType = "scriptmonitor\_alert\_new\_malicious\_url" Link to this property const PolicyUpdateParamsAlertTypeScriptmonitorAlertNewMaxLengthResourceURL PolicyUpdateParamsAlertType = "scriptmonitor\_alert\_new\_max\_length\_resource\_url" Link to this property const PolicyUpdateParamsAlertTypeScriptmonitorAlertNewResources PolicyUpdateParamsAlertType = "scriptmonitor\_alert\_new\_resources" Link to this property const PolicyUpdateParamsAlertTypeSecondaryDNSAllPrimariesFailing PolicyUpdateParamsAlertType = "secondary\_dns\_all\_primaries\_failing" Link to this property const PolicyUpdateParamsAlertTypeSecondaryDNSPrimariesFailing PolicyUpdateParamsAlertType = "secondary\_dns\_primaries\_failing" Link to this property const PolicyUpdateParamsAlertTypeSecondaryDNSWarning PolicyUpdateParamsAlertType = "secondary\_dns\_warning" Link to this property const PolicyUpdateParamsAlertTypeSecondaryDNSZoneSuccessfullyUpdated PolicyUpdateParamsAlertType = "secondary\_dns\_zone\_successfully\_updated" Link to this property const PolicyUpdateParamsAlertTypeSecondaryDNSZoneValidationWarning PolicyUpdateParamsAlertType = "secondary\_dns\_zone\_validation\_warning" Link to this property const PolicyUpdateParamsAlertTypeSecurityInsightsAlert PolicyUpdateParamsAlertType = "security\_insights\_alert" Link to this property const PolicyUpdateParamsAlertTypeSentinelAlert PolicyUpdateParamsAlertType = "sentinel\_alert" Link to this property const PolicyUpdateParamsAlertTypeStreamLiveNotifications PolicyUpdateParamsAlertType = "stream\_live\_notifications" Link to this property const PolicyUpdateParamsAlertTypeSyntheticTestLatencyAlert PolicyUpdateParamsAlertType = "synthetic\_test\_latency\_alert" Link to this property const PolicyUpdateParamsAlertTypeSyntheticTestLowAvailabilityAlert PolicyUpdateParamsAlertType = "synthetic\_test\_low\_availability\_alert" Link to this property const PolicyUpdateParamsAlertTypeTrafficAnomaliesAlert PolicyUpdateParamsAlertType = "traffic\_anomalies\_alert" Link to this property const PolicyUpdateParamsAlertTypeTunnelHealthEvent PolicyUpdateParamsAlertType = "tunnel\_health\_event" Link to this property const PolicyUpdateParamsAlertTypeTunnelUpdateEvent PolicyUpdateParamsAlertType = "tunnel\_update\_event" Link to this property const PolicyUpdateParamsAlertTypeUniversalSSLEventType PolicyUpdateParamsAlertType = "universal\_ssl\_event\_type" Link to this property const PolicyUpdateParamsAlertTypeWebAnalyticsMetricsUpdate PolicyUpdateParamsAlertType = "web\_analytics\_metrics\_update" Link to this property const PolicyUpdateParamsAlertTypeZoneAopCustomCertificateExpirationType PolicyUpdateParamsAlertType = "zone\_aop\_custom\_certificate\_expiration\_type" Link to this property
Link to this property Description param.Field\[string]Optional Body param: Optional description for the Notification policy. Link to this property Enabled param.Field\[bool]Optional Body param: Whether or not the Notification policy is enabled. Link to this property Filters param.Field\[PolicyFilter]Optional Body param: 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. Link to this property Mechanisms param.Field\[Mechanism]Optional Body param: List of IDs that will be used when dispatching a notification. IDs for email type will be the email address. Link to this property Name param.Field\[string]Optional Body param: Name of the policy. Link to this property
[Link to this property](<#(resource)%20alerting.policies%20%3E%20(method)%20update%20%3E%20(params)%20default>) ##### ReturnsExpand Collapse
type PolicyUpdateResponse struct{…} ID stringOptional UUID maxLength32 Link to this property
[Link to this property](<#(resource)%20alerting.policies%20%3E%20(model)%20PolicyUpdateResponse%20%3E%20(schema)>) ### Update a Notification policy Go HTTPTypeScriptPythonGoTerraform ``` package main import ( "context" "fmt" "github.com/cloudflare/cloudflare-go" "github.com/cloudflare/cloudflare-go/alerting" "github.com/cloudflare/cloudflare-go/option" ) func main() { client := cloudflare.NewClient( option.WithAPIToken("Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY"), ) policy, err := client.Alerting.Policies.Update( context.TODO(), "0da2b59ef118439d8097bdfb215203c9", alerting.PolicyUpdateParams{ AccountID: cloudflare.F("023e105f4ecef8ad9ca31a8372d0c353"), }, ) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", 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" } } ```