{"command":{"effect":"write","timeoutSeconds":30,"inputSchema":{"type":"object","description":"Update a Notification policy.","properties":{"path":{"type":"object","properties":{"account_id":{"$ref":"#/definitions/aaa_account-id"},"policy_id":{"$ref":"#/definitions/aaa_policy-id"}},"required":["account_id","policy_id"],"additionalProperties":false},"body":{"type":"object","properties":{"alert_interval":{"$ref":"#/definitions/aaa_alert_interval"},"alert_type":{"$ref":"#/definitions/aaa_alert_type"},"description":{"$ref":"#/definitions/aaa_schemas-description"},"enabled":{"$ref":"#/definitions/aaa_enabled"},"filters":{"$ref":"#/definitions/aaa_filters"},"mechanisms":{"$ref":"#/definitions/aaa_mechanisms"},"name":{"$ref":"#/definitions/aaa_schemas-name"}}}},"required":["path","body"],"additionalProperties":false,"definitions":{"aaa_account-id":{"description":"The account id","type":"string","maxLength":32,"examples":["023e105f4ecef8ad9ca31a8372d0c353"]},"aaa_policy-id":{"description":"The unique identifier of a notification policy","type":"string","maxLength":32,"examples":["0da2b59ef118439d8097bdfb215203c9"]},"aaa_alert_interval":{"description":"Optional specification of how often to re-alert from the same incident, not support on all alert types.","type":"string","examples":["30m"]},"aaa_alert_type":{"description":"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.","type":"string","enum":["abuse_report_alert","access_custom_certificate_expiration_type","advanced_ddos_attack_l4_alert","advanced_ddos_attack_l7_alert","advanced_http_alert_error","bgp_hijack_notification","billing_usage_alert","block_notification_block_removed","block_notification_new_block","block_notification_review_rejected","bot_traffic_basic_alert","brand_protection_alert","brand_protection_digest","clickhouse_alert_fw_anomaly","clickhouse_alert_fw_ent_anomaly","cloudforce_one_request_notification","cni_maintenance_notification","custom_analytics","custom_bot_detection_alert","custom_ssl_certificate_event_type","dedicated_ssl_certificate_event_type","device_connectivity_anomaly_alert","dos_attack_l4","dos_attack_l7","expiring_service_token_alert","failing_logpush_job_disabled_alert","fbm_auto_advertisement","fbm_dosd_attack","fbm_volumetric_attack","health_check_status_notification","hostname_aop_custom_certificate_expiration_type","http_alert_edge_error","http_alert_origin_error","image_notification","image_resizing_notification","incident_alert","load_balancing_health_alert","load_balancing_pool_enablement_alert","logo_match_alert","magic_tunnel_health_check_event","magic_wan_tunnel_health","maintenance_event_notification","mtls_certificate_store_certificate_expiration_type","pages_event_alert","radar_notification","real_origin_monitoring","scriptmonitor_alert_new_code_change_detections","scriptmonitor_alert_new_hosts","scriptmonitor_alert_new_malicious_hosts","scriptmonitor_alert_new_malicious_scripts","scriptmonitor_alert_new_malicious_url","scriptmonitor_alert_new_max_length_resource_url","scriptmonitor_alert_new_resources","secondary_dns_all_primaries_failing","secondary_dns_primaries_failing","secondary_dns_warning","secondary_dns_zone_successfully_updated","secondary_dns_zone_validation_warning","security_insights_alert","sentinel_alert","stream_live_notifications","synthetic_test_latency_alert","synthetic_test_low_availability_alert","traffic_anomalies_alert","tunnel_health_event","tunnel_update_event","universal_ssl_event_type","web_analytics_metrics_update","zone_aop_custom_certificate_expiration_type"],"examples":["universal_ssl_event_type"]},"aaa_schemas-description":{"description":"Optional description for the Notification policy.","type":"string","examples":["Something describing the policy."]},"aaa_enabled":{"description":"Whether or not the Notification policy is enabled.","type":"boolean","default":true,"examples":[true]},"aaa_filters":{"description":"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.","type":"object","properties":{"actions":{"description":"Usage depends on specific alert type","type":"array","items":{"type":"string"}},"affected_asns":{"description":"Used for configuring radar_notification","type":"array","items":{"type":"string"}},"affected_components":{"description":"Used for configuring incident_alert","type":"array","items":{"type":"string"},"examples":["4c231tkdlpcl"]},"affected_locations":{"description":"Used for configuring radar_notification","type":"array","items":{"type":"string"}},"airport_code":{"description":"Used for configuring maintenance_event_notification","type":"array","items":{"type":"string"}},"alert_trigger_preferences":{"description":"Usage depends on specific alert type","type":"array","items":{"type":"string"}},"alert_trigger_preferences_value":{"description":"Usage depends on specific alert type","type":"array","items":{"type":"string"}},"enabled":{"description":"Used for configuring load_balancing_pool_enablement_alert","type":"array","items":{"minItems":1,"type":"string"}},"environment":{"description":"Used for configuring pages_event_alert","type":"array","items":{"minItems":1,"type":"string"}},"event":{"description":"Used for configuring pages_event_alert","type":"array","items":{"minItems":1,"type":"string"}},"event_source":{"description":"Used for configuring load_balancing_health_alert","type":"array","items":{"type":"string"}},"event_type":{"description":"Usage depends on specific alert type","type":"array","items":{"type":"string"}},"group_by":{"description":"Usage depends on specific alert type","type":"array","items":{"type":"string"}},"health_check_id":{"description":"Used for configuring health_check_status_notification","type":"array","items":{"type":"string"}},"incident_impact":{"description":"Used for configuring incident_alert","type":"array","items":{"enum":["INCIDENT_IMPACT_NONE","INCIDENT_IMPACT_MINOR","INCIDENT_IMPACT_MAJOR","INCIDENT_IMPACT_CRITICAL"],"type":"string"}},"input_id":{"description":"Used for configuring stream_live_notifications","type":"array","items":{"type":"string"}},"insight_class":{"description":"Used for configuring security_insights_alert","type":"array","items":{"type":"string"}},"limit":{"description":"Used for configuring billing_usage_alert","type":"array","items":{"minItems":1,"type":"string"}},"logo_tag":{"description":"Used for configuring logo_match_alert","type":"array","items":{"type":"string"}},"megabits_per_second":{"description":"Used for configuring advanced_ddos_attack_l4_alert","type":"array","items":{"type":"string"}},"new_health":{"description":"Used for configuring load_balancing_health_alert","type":"array","items":{"type":"string"}},"new_status":{"description":"Used for configuring tunnel_health_event","type":"array","items":{"type":"string"}},"packets_per_second":{"description":"Used for configuring advanced_ddos_attack_l4_alert","type":"array","items":{"type":"string"}},"pool_id":{"description":"Usage depends on specific alert type","type":"array","items":{"type":"string"}},"pop_names":{"description":"Usage depends on specific alert type","type":"array","items":{"type":"string"}},"product":{"description":"Used for configuring billing_usage_alert","type":"array","items":{"minItems":1,"type":"string"}},"project_id":{"description":"Used for configuring pages_event_alert","type":"array","items":{"minItems":1,"type":"string"}},"protocol":{"description":"Used for configuring advanced_ddos_attack_l4_alert","type":"array","items":{"type":"string"}},"query_tag":{"description":"Usage depends on specific alert type","type":"array","items":{"type":"string"}},"requests_per_second":{"description":"Used for configuring advanced_ddos_attack_l7_alert","type":"array","items":{"type":"string"}},"selectors":{"description":"Usage depends on specific alert type","type":"array","items":{"type":"string"}},"services":{"description":"Used for configuring clickhouse_alert_fw_ent_anomaly","type":"array","items":{"minItems":1,"type":"string"}},"slo":{"description":"Usage depends on specific alert type","type":"array","items":{"type":"string"}},"status":{"description":"Used for configuring health_check_status_notification","type":"array","items":{"minItems":1,"type":"string"}},"target_hostname":{"description":"Used for configuring advanced_ddos_attack_l7_alert","type":"array","items":{"type":"string"}},"target_ip":{"description":"Used for configuring advanced_ddos_attack_l4_alert","type":"array","items":{"type":"string"}},"target_zone_name":{"description":"Used for configuring advanced_ddos_attack_l7_alert","type":"array","items":{"type":"string"}},"token_id":{"description":"Access service token IDs to include for expiring_service_token_alert. Omit this property to include all current and future service tokens.","type":"array","items":{"minLength":1,"pattern":"\\S","type":"string"},"minItems":1,"uniqueItems":true},"traffic_exclusions":{"description":"Used for configuring traffic_anomalies_alert","type":"array","items":{"enum":["security_events"],"maxItems":1,"type":"string"}},"tunnel_id":{"description":"Used for configuring tunnel_health_event","type":"array","items":{"type":"string"}},"tunnel_name":{"description":"Usage depends on specific alert type","type":"array","items":{"type":"string"}},"type":{"description":"Usage depends on specific alert type","type":"array","items":{"type":"string"}},"where":{"description":"Usage depends on specific alert type","type":"array","items":{"type":"string"}},"zones":{"description":"Usage depends on specific alert type","type":"array","items":{"type":"string"}}},"examples":[{"slo":["99.9"]}]},"aaa_mechanisms":{"description":"List of IDs that will be used when dispatching a notification. IDs for email type will be the email address.","type":"object","properties":{"email":{"type":"array","items":{"properties":{"id":{"description":"The email address","type":"string"}},"type":"object"}},"pagerduty":{"type":"array","items":{"properties":{"id":{"$ref":"#/definitions/aaa_uuid"}},"type":"object"}},"webhooks":{"type":"array","items":{"properties":{"id":{"$ref":"#/definitions/aaa_uuid"}},"type":"object"}}},"examples":[{"email":[{"id":"test@example.com"}],"pagerduty":[{"id":"e8133a15-00a4-4d69-aec1-32f70c51f6e5"}],"webhooks":[{"id":"14cc1190-5d2b-4b98-a696-c424cb2ad05f"}]}]},"aaa_schemas-name":{"description":"Name of the policy.","type":"string","examples":["SSL Notification Event Policy"]},"aaa_uuid":{"description":"UUID","type":"string","maxLength":32,"examples":["f174e90afafe4643bbbc4a0ed4fc8415"]}}},"name":"Update a Notification policy","id":"cloudflare.notification-policies-update-a-notification-policy","example":{"path":{"account_id":"023e105f4ecef8ad9ca31a8372d0c353","policy_id":"0da2b59ef118439d8097bdfb215203c9"},"body":{}},"maxRequests":1,"summary":false}}