Skip to main content
GET
Federation Clusters
string
Filter by spec.tier: critical, standard, non-critical (exact match)
Minimum role: viewer. Lists ClusterRegistrations of every namespace. The response is not paginated: metadata.page is 1 and pageSize equals the number of items. Item fields are described in List Clusters.

Authorizations

X-API-Key
string
header
required

API key sent in the X-API-Key header. Keys are read from the Secret chatcli-operator-secrets, key api-keys (fallback: ConfigMap chatcli-operator-config, key api-keys) in the operator namespace, as a YAML list of {key, role, name, description} (name is the identity recorded on approval decisions); the operator chart creates it only with apiKeys.create: true. Roles: viewer < operator < admin — any other role string is denied everywhere. Changes are picked up within about 30 seconds; deleting both the Secret and the ConfigMap revokes every key. With no keys configured every /api/ call returns 401, unless CHATCLI_OPERATOR_DEV_MODE=true, which grants admin without a key (development only).

Query Parameters

tier
enum<string>

Exact match on spec.tier.

Available options:
critical,
standard,
non-critical

Response

Federated cluster list

apiVersion
string
Example:

"v1"

kind
string
Example:

"ClusterRegistrationList"

metadata
object
items
object[]