IP Allowlist

Use these operations to interact with the IP allowlist in Cortex.

Required permissions

Your API key must have the Configure IP allowlist permission.

Operations

Gets allowlist of IP addresses & ranges

get

Authorizations

Query parameters

pageSizeinteger · int32Required

Number of results to return per page, between 1 and 1000. Default 250.

Default: 250

pageinteger · int32Required

Page number to return, 0-indexed. Default 0.

Default: 0

Responses

get

HTTPcURLJavaScriptPython

GET /api/v1/ip-allowlist HTTP/1.1
Host: api.getcortexapp.com
Authorization: Bearer JWT
Accept: */*

{
  "entries": [
    {
      "address": "10.0.0.1",
      "description": "text"
    }
  ],
  "page": 1,
  "total": 1,
  "totalPages": 1
}

Validates allowlist of IP addresses & ranges

post

Authorizations

Body

Responses

Responseone of

or

post

HTTPcURLJavaScriptPython

POST /api/v1/ip-allowlist/validate HTTP/1.1
Host: api.getcortexapp.com
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 57

{
  "entries": [
    {
      "address": "10.0.0.1",
      "description": "text"
    }
  ]
}

{
  "address": "10.0.0.1",
  "description": "text",
  "valid": true
}

Replace existing allowlist with provided list of IP addresses & ranges

put

Authorizations

Query parameters

forcebooleanOptional

When true, entries will be updated even if the list doesn't contain the requestor's IP address

Body

Responses

put

HTTPcURLJavaScriptPython

PUT /api/v1/ip-allowlist HTTP/1.1
Host: api.getcortexapp.com
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 57

{
  "entries": [
    {
      "address": "10.0.0.1",
      "description": "text"
    }
  ]
}

{
  "entries": [
    {
      "address": "10.0.0.1",
      "description": "text"
    }
  ],
  "page": 1,
  "total": 1,
  "totalPages": 1
}