Give Feedback

pydo.monitoring.list_alert_policy()

Generated on 8 May 2026 from pydo version v0.34.0

Copy page as Markdown View page as Markdown

Usage

client.monitoring.list_alert_policy(per_page=20, page=1)

Returns JSONRaises HttpResponseError

Description

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

Parameters

per_page integer optional

Number of items returned per page

Min: 1

Max: 200

Default: 20

page integer optional

Which 'page' of paginated results to return.

Min: 1

Default: 1

Request Sample

Show Request Sample

import os
from pydo import Client

client = Client(token=os.environ.get("DIGITALOCEAN_TOKEN"))

resp = client.monitoring.list_alert_policy()

Pagination

This method returns paginated results. The response includes a links.pages object with URLs for navigating between pages. To retrieve the next page, parse the next URL and pass the page parameter:

from urllib.parse import urlparse, parse_qs

resp = client.monitoring.list_alert_policy()
pages = resp.get("links", {}).get("pages", {})

while "next" in pages:
    parsed = urlparse(pages["next"])
    page = int(parse_qs(parsed.query)["page"][0])
    resp = client.monitoring.list_alert_policy(page=page)
    pages = resp.get("links", {}).get("pages", {})

Response Example

Show Response Example

{
  "policies": [
    {
      "alerts": {
        "email": [
          "[email protected]"
        ],
        "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
  }
}

More Information

See /v2/monitoring/alerts in the API reference for additional detail on responses, headers, parameters, and more.