k0rdent AI Docs

Servers

K0rdent Api Servers endpoints

Servers Endpoints

MethodEndpointDescription
GET/v1/regions/{region}/projects/{project}/infrastructure/serversList all bare metal hosts in the fleet inventory.
GET/v1/regions/{region}/projects/{project}/infrastructure/servers/{id}Retrieve detailed information about a specific server including health status.
GET/v1/regions/{region}/projects/{project}/infrastructure/servers/{id}/logsRetrieve provisioning and host status logs.
POST/v1/regions/{region}/projects/{project}/infrastructure/serversRegister a new bare metal host to the fleet inventory.
POST/v1/regions/{region}/projects/{project}/infrastructure/servers:batchCreateBulk enroll multiple servers via CSV or JSON file upload.
POST/v1/regions/{region}/projects/{project}/infrastructure/servers/{id}:{action}Drive and validate server lifecycle transitions.
POST/v1/regions/{region}/projects/{project}/infrastructure/servers/{id}:provisionInitiate host provisioning workflow to move host from Registered to Ready state.
POST/v1/regions/{region}/projects/{project}/infrastructure/servers/{id}:validateValidate host reachability and required metadata.
PATCH/v1/regions/{region}/projects/{project}/infrastructure/servers/{id}Update host metadata including tags and persona.
DELETE/v1/regions/{region}/projects/{project}/infrastructure/servers/{id}Remove server from fleet inventory when retired or failed.

How is this guide?

On this page