Create a public IPv4 network for a dedicated server

POST/v1/hosts/dedicated_servers/{server_id}/networks/public_ipv4

A POST request sent to the /v1/hosts/dedicated_servers/{server_id}/networks/public_ipv4 endpoint will initiate creation of a public IPv4 network for the selected server. Specify a host ID in the path parameter. The subnet mask is a required parameter to be mentioned in the request body. To order an alias IP, use the route method with a /32 mask.

Authorization

bearerAuth

AuthorizationBearer <token>

In: header

Path Parameters

server_id*string

A unique identifier of a server.

Request Body

application/json

distribution_method?string

A distribution method (see details in the response description). The route method is compatible only with a /32 mask for alias IP creation; use gateway to allocate networks with other masks.

Default"gateway"

Value in

"gateway"
"route"

mask*integer

A subnet mask. Available subnet sizes are /29 - /26 for gateway and /32 for the route method. If you need a /29 subnet, specify 29 in this parameter.

Response Body

`application/json`

curl -X POST "https://example.com/v1/hosts/dedicated_servers/l9avZgaG/networks/public_ipv4" \  -H "Content-Type: application/json" \  -d '{    "distribution_method": "gateway",    "mask": 29  }'

{  "id": "WPe9OYbL",  "title": "Alias",  "status": "new",  "cidr": null,  "family": "ipv4",  "interface_type": "public",  "distribution_method": "route",  "additional": true,  "updated_at": "2026-05-28T06:57:50Z",  "created_at": "2026-05-28T06:57:50Z"}

{  "message": "Networks limit exceeded",  "code": "NETWORKS_LIMIT_EXCEEDED"}

Create a public IPv4 network for a dedicated server

Authorization

Path Parameters

Request Body

Response Body

202application/json

409application/json

`application/json`

`application/json`