Proxy to Kubernetes API

curl --request GET \
  --url https://api.cnap.tech/v1/clusters/{id}/kube/{path} \
  --header 'Authorization: Bearer <token>'

{
  "error": {
    "code": "not_found",
    "message": "Resource not found",
    "param": "name",
    "suggestion": "Run `cnap clusters list` to see available clusters",
    "details": "<unknown>"
  }
}

Clusters

Proxy to Kubernetes API

Transparent proxy to the cluster’s Kubernetes API server. The path after /kube/ is forwarded directly. All HTTP methods are supported.

Examples:

GET /clusters/{id}/kube/api/v1/namespaces — list namespaces
GET /clusters/{id}/kube/api/v1/namespaces/{ns}/pods — list pods
GET /clusters/{id}/kube/api/v1/namespaces/{ns}/pods/{pod}/log?tailLines=100 — pod logs
GET /clusters/{id}/kube/apis/apps/v1/namespaces/{ns}/deployments — list deployments
GET /clusters/{id}/kube/openapi/v3 — Kubernetes OpenAPI spec

GET

clusters

{id}

kube

{path}

Proxy to Kubernetes API

curl --request GET \
  --url https://api.cnap.tech/v1/clusters/{id}/kube/{path} \
  --header 'Authorization: Bearer <token>'

{
  "error": {
    "code": "not_found",
    "message": "Resource not found",
    "param": "name",
    "suggestion": "Run `cnap clusters list` to see available clusters",
    "details": "<unknown>"
  }
}

Authorizations

Authorization

string

header

required

Personal Access Token (cnap_pat_...) or OAuth2 JWT. Create tokens at https://cnap.tech/account/tokens

Path Parameters

string

required

Cluster ID

path

string

required

Kubernetes API path

Example:

"api/v1/namespaces"

Response

Kubernetes API response

Generate worker join command and cloud-init

Execute command in pod