Skip to main content
POST
Add an IP allowlist entry

Authorizations

Authorization
string
header
required

A personal access token (POST /v1/auth/tokens) or a machine identity token (POST /v1/projects/{project_id}/identities/{identity_id}/tokens), both prefixed qumo_pat_. A token's scopes cap what it can do; see Scopes and permissions. A personal token names no organization: on a route whose path names no project or organization, pass ?organization_id=.

Path Parameters

project_id
string<uuid>
required

The project's id.

identity_id
string<uuid>
required

The identity's id.

Body

application/json
cidr
string
required

An IPv4 or IPv6 range in CIDR notation.

Example:

"203.0.113.0/24"

label
string
required

What the range is, for your own reference.

Maximum string length: 255
Example:

"Office network"

Response

The created entry.

A range an identity's tokens may be used from.

id
string<uuid>
required
Example:

"4e6a8c0d-2f4b-4a7e-8c1d-3b5f7a9c1e2d"

identity_id
string<uuid>
required
Example:

"c2a4e6f8-0b1d-4c3e-9f5a-7b9d1e3f5a6c"

cidr
string
required

The range, normalized to its network address.

Example:

"203.0.113.0/24"

label
string
required
Example:

"Office network"

created_at
string<date-time>
required
Example:

"2026-10-14T09:20:31Z"