Networks

Create a network

Declare a new network.

Required scope infrastructure:add

post/networks

Authorizations

Authorizationstringrequired

Authorization header carrying a workspace API key, as “Bearer kbn_live_…”. The X-Api-Key header is accepted equivalently.

Bodyapplication/json

namestringrequired

Name of the network.

roleenum<string>required

Role the network plays.

Available options: local, wireless, storage, vpn, data_center, edge, public, management, dmz, iot, intercommunication

ipAddressstringrequired

Base address of the network.

subnetstringrequired

Subnet in CIDR notation, for example `/24`.

descriptionstring

Free-text description of the network.

vlanIdinteger

VLAN the network is carried on.

Response201 · application/json

The network was created.

idstring<uuid>required

Identifier of the network.

namestringrequired

Name of the network.

roleenum<string>required

Role the network plays.

Available options: local, wireless, storage, vpn, data_center, edge, public, management, dmz, iot, intercommunication

ipAddressstring

Base address of the network.

subnetstring

Subnet in CIDR notation.

descriptionstring | null

Free-text description of the network.

vlanIdinteger | null

VLAN the network is carried on.

routersobject[]

Routers connected to the network.