Skip to main content
POST
/
prefix-lists
Create a prefix list
curl --request POST \
  --url https://api.altostrat.io/prefix-lists \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "Corporate Office IPs",
  "description": "Static IPs for our main corporate office.",
  "prefixes": [
    {
      "cidr": "203.0.113.0/28",
      "description": "Primary ISP Block"
    },
    {
      "cidr": "198.51.100.10/32",
      "description": "Backup ISP"
    }
  ],
  "sites": []
}'
{
  "id": "prfx_lst_0ujsswThIGTUYm2K8FjOOfxcYpw",
  "name": "Main Office IPs",
  "description": "Public IP ranges for the main office.",
  "status": "active",
  "sites": [
    "site_12345"
  ],
  "prefixes": [
    {
      "id": "prfx_0ujsswThIGTUYm2K8FjOOfxcYpw",
      "cidr": "192.0.2.0/24",
      "description": "Main server subnet"
    }
  ]
}

Authorizations

โ€‹
Authorization
string
header
required

Authentication is performed via an Auth0-issued JSON Web Token (JWT). Provide the token in the Authorization header with the Bearer scheme.

Body

application/json

The details of the new prefix list.

Defines the writable properties for creating or updating a prefix list.

โ€‹
name
string
required

A human-readable name for the prefix list.

Maximum length: 255
Example:

"Third-Party API Endpoints"

โ€‹
prefixes
object[]
required

A list of prefixes (CIDR blocks). The entire list is replaced on update.

Maximum length: 500
โ€‹
sites
string[]
required

A list of site IDs where this prefix list should be directly applied. The entire list of sites is replaced on update.

โ€‹
description
string | null

An optional description for the prefix list.

Maximum length: 1000
Example:

"Static IPs for services we integrate with."

Response

The prefix list was created successfully.

Represents a reusable, named collection of IP addresses and CIDR blocks.

โ€‹
id
string

The unique identifier for the prefix list, prefixed with prfx_lst_.

Example:

"prfx_lst_0ujsswThIGTUYm2K8FjOOfxcYpw"

โ€‹
name
string

A human-readable name for the prefix list.

Example:

"Main Office IPs"

โ€‹
description
string

An optional description for the prefix list.

Example:

"Public IP ranges for the main office."

โ€‹
status
enum<string>

The current synchronization status of the prefix list.

Available options:
active,
syncing,
failed
Example:

"active"

โ€‹
sites
string[]

A list of site IDs where this prefix list is directly applied.

โ€‹
prefixes
object[]

The list of CIDR blocks in this prefix list.