API Reference

Alerting

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Policies

List Notification policies

client.Alerting.Policies.List(ctx, query) (*SinglePage[Policy], error)

GET/accounts/{account_id}/alerting/v3/policies

Get a Notification policy

client.Alerting.Policies.Get(ctx, policyID, query) (*Policy, error)

GET/accounts/{account_id}/alerting/v3/policies/{policy_id}

Create a Notification policy

client.Alerting.Policies.New(ctx, params) (*PolicyNewResponse, error)

POST/accounts/{account_id}/alerting/v3/policies

Update a Notification policy

client.Alerting.Policies.Update(ctx, policyID, params) (*PolicyUpdateResponse, error)

PUT/accounts/{account_id}/alerting/v3/policies/{policy_id}

Delete a Notification policy

client.Alerting.Policies.Delete(ctx, policyID, body) (*PolicyDeleteResponse, error)

DELETE/accounts/{account_id}/alerting/v3/policies/{policy_id}

ModelsExpand Collapse

type Mechanism struct{…}

List of IDs that will be used when dispatching a notification. IDs for email type will be the email address.

Email []MechanismEmailOptional

ID stringOptional

The email address

Pagerduty []MechanismPagerdutyOptional

ID stringOptional

UUID

maxLength32

Webhooks []MechanismWebhookOptional

ID stringOptional

UUID

maxLength32

type Policy struct{…}

ID stringOptional

The unique identifier of a notification policy

maxLength32

AlertInterval stringOptional

Optional specification of how often to re-alert from the same incident, not support on all alert types.

AlertType PolicyAlertTypeOptional

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:

const PolicyAlertTypeAbuseReportAlert PolicyAlertType = "abuse_report_alert"

const PolicyAlertTypeAccessCustomCertificateExpirationType PolicyAlertType = "access_custom_certificate_expiration_type"

const PolicyAlertTypeAdvancedDDoSAttackL4Alert PolicyAlertType = "advanced_ddos_attack_l4_alert"

const PolicyAlertTypeAdvancedDDoSAttackL7Alert PolicyAlertType = "advanced_ddos_attack_l7_alert"

const PolicyAlertTypeAdvancedHTTPAlertError PolicyAlertType = "advanced_http_alert_error"

const PolicyAlertTypeBGPHijackNotification PolicyAlertType = "bgp_hijack_notification"

const PolicyAlertTypeBillingUsageAlert PolicyAlertType = "billing_usage_alert"

const PolicyAlertTypeBlockNotificationBlockRemoved PolicyAlertType = "block_notification_block_removed"

const PolicyAlertTypeBlockNotificationNewBlock PolicyAlertType = "block_notification_new_block"

const PolicyAlertTypeBlockNotificationReviewRejected PolicyAlertType = "block_notification_review_rejected"

const PolicyAlertTypeBotTrafficBasicAlert PolicyAlertType = "bot_traffic_basic_alert"

const PolicyAlertTypeBrandProtectionAlert PolicyAlertType = "brand_protection_alert"

const PolicyAlertTypeBrandProtectionDigest PolicyAlertType = "brand_protection_digest"

const PolicyAlertTypeClickhouseAlertFwAnomaly PolicyAlertType = "clickhouse_alert_fw_anomaly"

const PolicyAlertTypeClickhouseAlertFwEntAnomaly PolicyAlertType = "clickhouse_alert_fw_ent_anomaly"

const PolicyAlertTypeCloudforceOneRequestNotification PolicyAlertType = "cloudforce_one_request_notification"

const PolicyAlertTypeCNIMaintenanceNotification PolicyAlertType = "cni_maintenance_notification"

const PolicyAlertTypeCustomAnalytics PolicyAlertType = "custom_analytics"

const PolicyAlertTypeCustomBotDetectionAlert PolicyAlertType = "custom_bot_detection_alert"

const PolicyAlertTypeCustomSSLCertificateEventType PolicyAlertType = "custom_ssl_certificate_event_type"

const PolicyAlertTypeDedicatedSSLCertificateEventType PolicyAlertType = "dedicated_ssl_certificate_event_type"

const PolicyAlertTypeDeviceConnectivityAnomalyAlert PolicyAlertType = "device_connectivity_anomaly_alert"

const PolicyAlertTypeDosAttackL4 PolicyAlertType = "dos_attack_l4"

const PolicyAlertTypeDosAttackL7 PolicyAlertType = "dos_attack_l7"

const PolicyAlertTypeExpiringServiceTokenAlert PolicyAlertType = "expiring_service_token_alert"

const PolicyAlertTypeFailingLogpushJobDisabledAlert PolicyAlertType = "failing_logpush_job_disabled_alert"

const PolicyAlertTypeFbmAutoAdvertisement PolicyAlertType = "fbm_auto_advertisement"

const PolicyAlertTypeFbmDosdAttack PolicyAlertType = "fbm_dosd_attack"

const PolicyAlertTypeFbmVolumetricAttack PolicyAlertType = "fbm_volumetric_attack"

const PolicyAlertTypeHealthCheckStatusNotification PolicyAlertType = "health_check_status_notification"

const PolicyAlertTypeHostnameAopCustomCertificateExpirationType PolicyAlertType = "hostname_aop_custom_certificate_expiration_type"

const PolicyAlertTypeHTTPAlertEdgeError PolicyAlertType = "http_alert_edge_error"

const PolicyAlertTypeHTTPAlertOriginError PolicyAlertType = "http_alert_origin_error"

const PolicyAlertTypeImageNotification PolicyAlertType = "image_notification"

const PolicyAlertTypeImageResizingNotification PolicyAlertType = "image_resizing_notification"

const PolicyAlertTypeIncidentAlert PolicyAlertType = "incident_alert"

const PolicyAlertTypeLoadBalancingHealthAlert PolicyAlertType = "load_balancing_health_alert"

const PolicyAlertTypeLoadBalancingPoolEnablementAlert PolicyAlertType = "load_balancing_pool_enablement_alert"

const PolicyAlertTypeLogoMatchAlert PolicyAlertType = "logo_match_alert"

const PolicyAlertTypeMagicTunnelHealthCheckEvent PolicyAlertType = "magic_tunnel_health_check_event"

const PolicyAlertTypeMagicWANTunnelHealth PolicyAlertType = "magic_wan_tunnel_health"

const PolicyAlertTypeMaintenanceEventNotification PolicyAlertType = "maintenance_event_notification"

const PolicyAlertTypeMTLSCertificateStoreCertificateExpirationType PolicyAlertType = "mtls_certificate_store_certificate_expiration_type"

const PolicyAlertTypePagesEventAlert PolicyAlertType = "pages_event_alert"

const PolicyAlertTypeRadarNotification PolicyAlertType = "radar_notification"

const PolicyAlertTypeRealOriginMonitoring PolicyAlertType = "real_origin_monitoring"

const PolicyAlertTypeScriptmonitorAlertNewCodeChangeDetections PolicyAlertType = "scriptmonitor_alert_new_code_change_detections"

const PolicyAlertTypeScriptmonitorAlertNewHosts PolicyAlertType = "scriptmonitor_alert_new_hosts"

const PolicyAlertTypeScriptmonitorAlertNewMaliciousHosts PolicyAlertType = "scriptmonitor_alert_new_malicious_hosts"

const PolicyAlertTypeScriptmonitorAlertNewMaliciousScripts PolicyAlertType = "scriptmonitor_alert_new_malicious_scripts"

const PolicyAlertTypeScriptmonitorAlertNewMaliciousURL PolicyAlertType = "scriptmonitor_alert_new_malicious_url"

const PolicyAlertTypeScriptmonitorAlertNewMaxLengthResourceURL PolicyAlertType = "scriptmonitor_alert_new_max_length_resource_url"

const PolicyAlertTypeScriptmonitorAlertNewResources PolicyAlertType = "scriptmonitor_alert_new_resources"

const PolicyAlertTypeSecondaryDNSAllPrimariesFailing PolicyAlertType = "secondary_dns_all_primaries_failing"

const PolicyAlertTypeSecondaryDNSPrimariesFailing PolicyAlertType = "secondary_dns_primaries_failing"

const PolicyAlertTypeSecondaryDNSWarning PolicyAlertType = "secondary_dns_warning"

const PolicyAlertTypeSecondaryDNSZoneSuccessfullyUpdated PolicyAlertType = "secondary_dns_zone_successfully_updated"

const PolicyAlertTypeSecondaryDNSZoneValidationWarning PolicyAlertType = "secondary_dns_zone_validation_warning"

const PolicyAlertTypeSecurityInsightsAlert PolicyAlertType = "security_insights_alert"

const PolicyAlertTypeSentinelAlert PolicyAlertType = "sentinel_alert"

const PolicyAlertTypeStreamLiveNotifications PolicyAlertType = "stream_live_notifications"

const PolicyAlertTypeSyntheticTestLatencyAlert PolicyAlertType = "synthetic_test_latency_alert"

const PolicyAlertTypeSyntheticTestLowAvailabilityAlert PolicyAlertType = "synthetic_test_low_availability_alert"

const PolicyAlertTypeTrafficAnomaliesAlert PolicyAlertType = "traffic_anomalies_alert"

const PolicyAlertTypeTunnelHealthEvent PolicyAlertType = "tunnel_health_event"

const PolicyAlertTypeTunnelUpdateEvent PolicyAlertType = "tunnel_update_event"

const PolicyAlertTypeUniversalSSLEventType PolicyAlertType = "universal_ssl_event_type"

const PolicyAlertTypeWebAnalyticsMetricsUpdate PolicyAlertType = "web_analytics_metrics_update"

const PolicyAlertTypeZoneAopCustomCertificateExpirationType PolicyAlertType = "zone_aop_custom_certificate_expiration_type"

Created TimeOptional

formatdate-time

Description stringOptional

Optional description for the Notification policy.

Enabled boolOptional

Whether or not the Notification policy is enabled.

Filters PolicyFilterOptional

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.

Mechanisms MechanismOptional

List of IDs that will be used when dispatching a notification. IDs for email type will be the email address.

Modified TimeOptional

formatdate-time

Name stringOptional

Name of the policy.

type PolicyFilter struct{…}

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 []stringOptional

Usage depends on specific alert type

AffectedASNs []stringOptional

Used for configuring radar_notification

AffectedComponents []stringOptional

Used for configuring incident_alert

AffectedLocations []stringOptional

Used for configuring radar_notification

AirportCode []stringOptional

Used for configuring maintenance_event_notification

AlertTriggerPreferences []stringOptional

Usage depends on specific alert type

AlertTriggerPreferencesValue []stringOptional

Usage depends on specific alert type

Enabled []stringOptional

Used for configuring load_balancing_pool_enablement_alert

Environment []stringOptional

Used for configuring pages_event_alert

Event []stringOptional

Used for configuring pages_event_alert

EventSource []stringOptional

Used for configuring load_balancing_health_alert

EventType []stringOptional

Usage depends on specific alert type

GroupBy []stringOptional

Usage depends on specific alert type

HealthCheckID []stringOptional

Used for configuring health_check_status_notification

IncidentImpact []PolicyFilterIncidentImpactOptional

Used for configuring incident_alert

One of the following:

const PolicyFilterIncidentImpactIncidentImpactNone PolicyFilterIncidentImpact = "INCIDENT_IMPACT_NONE"

const PolicyFilterIncidentImpactIncidentImpactMinor PolicyFilterIncidentImpact = "INCIDENT_IMPACT_MINOR"

const PolicyFilterIncidentImpactIncidentImpactMajor PolicyFilterIncidentImpact = "INCIDENT_IMPACT_MAJOR"

const PolicyFilterIncidentImpactIncidentImpactCritical PolicyFilterIncidentImpact = "INCIDENT_IMPACT_CRITICAL"

InputID []stringOptional

Used for configuring stream_live_notifications

InsightClass []stringOptional

Used for configuring security_insights_alert

Limit []stringOptional

Used for configuring billing_usage_alert

LogoTag []stringOptional

Used for configuring logo_match_alert

MegabitsPerSecond []stringOptional

Used for configuring advanced_ddos_attack_l4_alert

NewHealth []stringOptional

Used for configuring load_balancing_health_alert

NewStatus []stringOptional

Used for configuring tunnel_health_event

PacketsPerSecond []stringOptional

Used for configuring advanced_ddos_attack_l4_alert

PoolID []stringOptional

Usage depends on specific alert type

POPNames []stringOptional

Usage depends on specific alert type

Product []stringOptional

Used for configuring billing_usage_alert

ProjectID []stringOptional

Used for configuring pages_event_alert

Protocol []stringOptional

Used for configuring advanced_ddos_attack_l4_alert

QueryTag []stringOptional

Usage depends on specific alert type

RequestsPerSecond []stringOptional

Used for configuring advanced_ddos_attack_l7_alert

Selectors []stringOptional

Usage depends on specific alert type

Services []stringOptional

Used for configuring clickhouse_alert_fw_ent_anomaly

Slo []stringOptional

Usage depends on specific alert type

Status []stringOptional

Used for configuring health_check_status_notification

TargetHostname []stringOptional

Used for configuring advanced_ddos_attack_l7_alert

TargetIP []stringOptional

Used for configuring advanced_ddos_attack_l4_alert

TargetZoneName []stringOptional

Used for configuring advanced_ddos_attack_l7_alert

TokenID []stringOptional

Access service token IDs to include for expiring_service_token_alert. Omit this property to include all current and future service tokens.

TrafficExclusions []PolicyFilterTrafficExclusionOptional

Used for configuring traffic_anomalies_alert

TunnelID []stringOptional

Used for configuring tunnel_health_event

TunnelName []stringOptional

Usage depends on specific alert type

Type []stringOptional

Usage depends on specific alert type

Where []stringOptional

Usage depends on specific alert type

Zones []stringOptional

Usage depends on specific alert type