POST
Create a subnet

Authorizations

Authorization
string
header
required

Bearer token for authentication. Format: 'Bearer {token}'

Headers

X-Workspace-Id
string

Workspace ID (uses default workspace if not provided)

Path Parameters

uuid
string
required

VPC UUID

Body

application/json

Create a subnet

name
string
required

Subnet name, unique within the VPC

family
enum<string>
default:dual

Address families the subnet runs. dual (default), ipv4 for no IPv6 at all, or ipv6 for no IPv4.

Available options:
dual,
ipv4,
ipv6
cidr_v4
string

IPv4 range inside the VPC. Required unless family is ipv6.

cidr_v6
string

IPv6 range. Derived from the VPC's own when omitted; required when family is ipv6.

public
boolean
default:true

Public keeps the platform default route on eth0; private moves it to the VPC so egress leaves through your own gateway. This is the only difference between the two.

Response

Create a subnet

Api_V1_Entities_VpcSubnet model

uuid
string
required

Unique subnet identifier

name
string
required

Subnet name, unique within the VPC

status
string
required

Current status (pending, active, failed, deleting)

cidr_v4
string
required

IPv4 range, carved out of the VPC's own

cidr_v6
string
required

IPv6 range

family
string
required

Address families the subnet runs (dual, ipv4, ipv6)

gateway_v4
string
required

IPv4 gateway for this subnet

gateway_v6
string
required

IPv6 gateway for this subnet

public
boolean
required

Public keeps the platform default route; private moves it to the VPC so egress leaves through your own gateway

attachment_count
integer<int32>
required

Number of attached workloads

created_at
string<date-time>
required

Creation timestamp