Servers

List servers

Search, filter and sort the servers of your workspace. Paginated in the database.

Required scope infrastructure:read

get/servers

Authorizations

Authorizationstringrequired

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

Query parameters

searchstring

Free-text search on the server name.

typestring

Keep only servers of this kind.

locationstring

Keep only servers at this location.

criticalitystring

Keep only servers at this business criticality.

osstring

Keep only servers running this operating system.

tagstring

Keep only servers carrying this tag.

applicationIdstring<uuid>

Keep only servers hosting this application.

sortstring

Field to sort on.

directionenum<string>

Sort direction.

Available options: asc, desc

limitintegerdefault 50

Page size. Clamped to [1, 200] — out-of-range values are silently brought back into range, never rejected.

min: 1 · max: 200

offsetintegerdefault 0

Number of items to skip. Floored at 0.

min: 0

Response200 · application/json

A page of servers.

dataany[]required

The page of items.

paginationobjectrequired

Offset pagination envelope shared by every paginated list endpoint.