Sign in

v12

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

Create VPC

Create a new virtual private cloud. Pick a cidr block that doesn't overlap with any of your existing VPCs.

CIDR planning

Use GET /api/v1/vpcs/cidr-suggestions to get suggested non-overlapping CIDR blocks if you don't have one in mind.

post/api/v1/vpcs

Headers

X-Project-IDstring uuid required

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

Request body

namestring required

VPC name.

cidrstring required

CIDR block. Must not overlap with other VPCs in the account. See GET /api/v1/vpcs/cidr-suggestions for non-overlapping options.

region'us-east'

Region for the VPC. Defaults to us-east.

Example request

{
  "name": "vpc-prod",
  "cidr": "10.0.0.0/24",
  "region": "us-east"
}

Response

VPC created

successboolean

Example response

{
  "data": {
    "name": "vpc-prod",
    "cidr": "10.0.0.0/24",
    "gateway": "10.0.0.1",
    "status": "active",
    "total_ips": 256,
    "used_ips": 4
  }
}