Xeonr Developer Docs
API SpecificationWarm Pools

Delete Pool

POST
/containers.api.v1.PoolService/DeletePool

Deletes a lane's pool configuration and drains its warm pods. Returns Unimplemented when warm pools are disabled (no Redis configured).

Access: operator or admin role in the pool's namespace, or a platform admin.

Authorization

BearerAuth
AuthorizationBearer <token>

A namespace-scoped API key (cpk_…) for machines, or a Xeonr Auth OIDC token for humans. The key's namespace and role are pinned server-side.

In: header

Header Parameters

Connect-Protocol-Version?number

Define the version of the Connect protocol

Connect-Timeout-Ms?number

Define the timeout, in ms

Request Body

application/json

lane?string
Length1 <= length <= 255
[key: string]?never

Response Body

application/json

application/json

curl -X POST "https://containers.xeonr.io/containers.api.v1.PoolService/DeletePool" \  -H "Connect-Protocol-Version: 1" \  -H "Connect-Timeout-Ms: 1000" \  -H "Content-Type: application/json" \  -d '{}'
{}
{
  "code": "not_found",
  "message": "string",
  "details": [
    {
      "type": "string",
      "value": "string",
      "debug": {}
    }
  ]
}

Configure Pool POST

Creates or replaces the warm pool for `lane`, warming pods from `environment_id`, which must be in `namespace`. `min_idle` must not exceed `max` when `max` is set. Returns Unimplemented when warm pools are disabled (no Redis configured). **Access:** operator or admin role in the namespace (via Xeonr team role or a namespace API key), or a platform admin.

Get Pool State POST

Returns live warm-pool telemetry: cumulative counters, per-lane idle/busy/target gauges and the pod-create latency EWMA. With `namespace` set, lanes are limited to that namespace's pools; empty returns every lane and requires a platform admin. Returns Unimplemented when warm pools are disabled (no Redis configured). **Access:** any role in the namespace (viewer, operator or admin — via Xeonr team membership or a namespace API key), or a platform admin.