Routers

Update a router

Partial update — every field is optional.

Required scope infrastructure:edit

patch/routers/{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 equipment.

Bodyapplication/json

namestring

Name of the equipment.

typeenum<string>

Kind of equipment.

Available options: router, firewall, switch, access_point

ipAddressstring

Management address of the equipment.

locationstring

Where the equipment sits.

descriptionstring

Free-text description of the equipment.

internetConnectionstring

Internet link the equipment carries.

Response200 · application/json

The updated equipment record.

idstring<uuid>required

Identifier of the equipment.

namestringrequired

Name of the equipment.

typeenum<string>required

Kind of equipment.

Available options: router, firewall, switch, access_point

ipAddressstring | null

Management address of the equipment.

locationstring | null

Where the equipment sits.

descriptionstring | null

Free-text description of the equipment.

internetConnectionstring | null

Internet link the equipment carries.

criticalitystring | null

Business criticality of the equipment.

tagsany[]

Tags attached to the equipment.

networksobject[]

Networks the equipment is connected to.

customFieldsany[]

Workspace custom fields and their values.