Servers

Add or update an interface

Create the interface if the address is new, update it otherwise. Returns the recomputed list of interfaces rather than the single one you sent.

Required scope infrastructure:edit

put/servers/{id}/interfaces/{ipAddress}

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 server.

ipAddressstringrequired

IP address of the interface.

Bodyapplication/json

primaryboolean

Whether this becomes the primary interface.

networkIdstring<uuid>

Network to attach the interface to.

Response200 · application/json

The interfaces after the change.

ipAddressstringrequired

IP address carried by the interface.

primarybooleanrequired

Whether this is the primary interface of the server.

networkobject | null

Network the interface is attached to.