v1

latestOpenAPI 3.0.22026-07-144652931.4 MB
IP Allow Lists

Create an IP allow list

<!-- theme: warning -->

Early Access

This API is in Early Access and may change at any time. You must pass the X-EARLY-ACCESS: ip-allow-lists header on every request, and your account must be enrolled in the IP Allow Lists Early Access program. Contact your PagerDuty account team to request access.

Create the account's IP allow list.

Only Account Owners, Global Admins, and Account API Keys can call this endpoint.

Scoped OAuth requires: ip_allow_lists.write

post/ip_allow_lists

Headers

X-EARLY-ACCESS'ip-allow-lists' required

This API is currently in Early Access. You MUST pass in this header with the value ip-allow-lists, and your account must be enrolled in the IP Allow Lists Early Access program. Contact your PagerDuty account team to request access.

Acceptstring required

The Accept header is used as a versioning header.

Content-Type'application/json' required

Request body

Example request

{
  "ip_allow_list": {
    "id": "AGIS47HYOV6BDODBTMQKMPQPHU",
    "type": "ip_allow_list",
    "state": "enabled",
    "cidr_entries": [
      {
        "cidr": "192.168.1.0/24",
        "description": "Office VPN"
      },
      {
        "cidr": "10.0.0.0/24",
        "description": "Data Center"
      }
    ]
  }
}

Response

IP allow list created.

Example response

{
  "ip_allow_list": {
    "id": "AGIS47HYOV6BDODBTMQKMPQPHU",
    "type": "ip_allow_list",
    "state": "enabled",
    "cidr_entries": [
      {
        "cidr": "192.168.1.0/24",
        "description": "Office VPN"
      },
      {
        "cidr": "10.0.0.0/24",
        "description": "Data Center"
      }
    ]
  }
}