Skip to main content
GET
Get Cluster
string
required
ClusterRegistration name
string
Namespace where the ClusterRegistration lives. When omitted, every namespace is searched.
Minimum role: viewer. spec and status carry the same flattened object (see List Clusters for the fields). The kubeconfig Secret reference, health-check interval, capabilities and conditions are not returned; use kubectl get clusterregistration <name> -o yaml for those.

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

Path Parameters

name
string
required

ClusterRegistration name.

Example:

"prod-us-east-1"

Query Parameters

namespace
string

Namespace of the object. When omitted, all namespaces are searched and the first object with this name is used.

Response

Cluster found

apiVersion
string
Example:

"v1"

kind
string
Example:

"ClusterRegistration"

spec
object
status
object
resourceMeta
object