v12

latestOpenAPI 3.0.3raw.githubusercontent.com2026-06-1811583196.1 KB
Networking

Suggest non-overlapping CIDR blocks

Returns suggested CIDR blocks that don't overlap with the account's existing VPCs. Use one of these as cidr when creating a new VPC.

get/api/v1/vpcs/cidr-suggestions

Headers

X-Project-IDstring uuid required

Project ID. Required for all mutating operations (create, delete, power actions, resize).

Response

CIDR suggestions

successboolean required
suggestedstring

Recommended CIDR — non-overlapping and right-sized for typical use.

suggested_ipsinteger

Number of usable IPs in the suggested block.

existing_countinteger

Number of VPCs you already have.

Example response

{
  "suggested": "10.1.0.0/24",
  "suggested_ips": 256,
  "alternatives": [
    {
      "cidr": "10.2.0.0/24",
      "available_ips": 256
    }
  ]
}