Status Pages

List email access policies

Changed on

Lists the email access policies for a private status page.

get/api/v2/statuspages/{page_id}/access_policies/email

Request

  • Base URL
    https://api.datadoghq.com
  • Auth
    • API key in header DD-API-KEY and API key in header DD-APPLICATION-KEY
    • or OAuth 2
      Authorization code/oauth2/v1/authorize
      Token URL/oauth2/v1/token
      Scopesstatus_pages_settings_read

Path parameters

page_idstring uuid required
Example:1234abcd-12ab-34cd-56ef-123456abcdef

The ID of the private status page.

Query parameters

includestring

Comma-separated list of resources to include. Supported values: created_by_user, status_page.

Response

OK

Example response

{
  "data": [
    {
      "attributes": {
        "created_at": "2026-01-01T00:00:00.000Z",
        "effect": "allow",
        "pattern": "@example.com"
      },
      "id": "1234abcd-12ab-34cd-56ef-123456abcdef",
      "relationships": {
        "created_by_user": {
          "data": {
            "id": "1234abcd-12ab-34cd-56ef-123456abcdef",
            "type": "users"
          }
        },
        "status_page": {
          "data": {
            "id": "1234abcd-12ab-34cd-56ef-123456abcdef",
            "type": "status_pages"
          }
        }
      },
      "type": "email_access_policies"
    }
  ],
  "included": [
    {
      "type": "users"
    }
  ]
}

Changes

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      endpoint added