Networks

Update a network

Partial update — every field is optional.

Required scope infrastructure:edit

patch/networks/{id}

Authorizations

Authorizationstringrequired

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

Path parameters

idstring<uuid>required

Identifier of the network.

Bodyapplication/json

namestring

Name of the network.

roleenum<string>

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, for example `/24`.

descriptionstring

Free-text description of the network.

vlanIdinteger

VLAN the network is carried on.

Response200 · application/json

The updated network record.

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.