Skip to main content
GET
/
api
/
v1
/
vpcs
/
cidr-suggestions
Suggest non-overlapping CIDR blocks
curl --request GET \
  --url https://api.rafftechnologies.com/api/v1/vpcs/cidr-suggestions \
  --header 'X-API-Key: <api-key>' \
  --header 'X-Project-ID: <x-project-id>'
{
  "success": true,
  "suggested": "10.1.0.0/24",
  "suggested_ips": 256,
  "alternatives": [
    {
      "cidr": "10.2.0.0/24",
      "available_ips": 256,
      "size": "small"
    }
  ],
  "existing_count": 123
}

Documentation Index

Fetch the complete documentation index at: https://docs.rafftechnologies.com/llms.txt

Use this file to discover all available pages before exploring further.

Updated May 8, 2026

Authorizations

​
X-API-Key
string
header
required

API key for authentication. Each key is bound to a specific account.

Headers

​
X-Project-ID
string<uuid>
required

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

Response

CIDR suggestions

​
success
boolean
required
​
suggested
string

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

Example:

"10.1.0.0/24"

​
suggested_ips
integer

Number of usable IPs in the suggested block.

Example:

256

​
alternatives
object[]

Other non-overlapping CIDRs to choose from, sized small/medium/large.

​
existing_count
integer

Number of VPCs you already have.

Last modified on May 8, 2026