v8

latestOpenAPI 3.0.0Apache 2.0raw.githubusercontent.com2025-10-165266542.4 MB
DigitalOcean-public.v2-new_Monitoring

List Alert Policies

Returns all alert policies that are configured for the given account. To List all alert policies, send a GET request to /v2/monitoring/alerts.

get/v2/monitoring/alerts

Query parameters

per_pageinteger

Number of items returned per page

pageinteger

Which 'page' of paginated results to return.

Response

A list of alert policies.

Example response

{
  "policies": [
    {
      "alerts": {
        "email": [
          "bob@example.com"
        ],
        "slack": [
          {
            "channel": "Production Alerts",
            "url": "https://hooks.slack.com/services/T1234567/AAAAAAAA/ZZZZZZ\""
          }
        ]
      },
      "compare": "GreaterThan",
      "description": "CPU Alert",
      "enabled": true,
      "entities": [
        192018292
      ],
      "tags": [
        "production_droplets"
      ],
      "type": "v1/insights/droplet/cpu",
      "uuid": "78b3da62-27e5-49ba-ac70-5db0b5935c64",
      "value": 80,
      "window": "5m"
    }
  ],
  "links": {
    "first": "https//api.digitalocean.com/v2/monitoring/alerts?page=1&per_page=10",
    "prev": "https//api.digitalocean.com/v2/monitoring/alerts?page=2&per_page=10",
    "next": "https//api.digitalocean.com/v2/monitoring/alerts?page=4&per_page=10",
    "last": "https//api.digitalocean.com/v2/monitoring/alerts?page=5&per_page=10"
  },
  "meta": {
    "total": 50
  }
}