Get cluster connection details API Reference

GET

/tenants/{tenant}/clusters/{name}/connection-details

curl --request GET \
  --url https://api.kupe.cloud/api/v1/tenants/acme/clusters/production/connection-details \
  --header 'Authorization: <Authorization>'

Retrieve the API endpoint and CA certificate for connecting to a managed cluster. Use these details to assemble a kubeconfig with your own auth (OIDC, etc.).

Returns 503 if the cluster is not yet ready (still provisioning).

Authorizations

• BearerAuth

Parameters

Path Parameters

tenant

required

string

Tenant name

name

required

string

Cluster name

Responses

200

Connection details

Media type application/json

object

certificateAuthority

string

endpoint

string

Example

{
  "certificateAuthority": "LS0tLS1CRUdJTi...",
  "endpoint": "https://production.acme.clusters.kupe.cloud"
}

400

Invalid name

Media type application/json

object

code

string

error

string

field

string

message

string

severity

string

Example ^generated

{
  "code": "example",
  "error": "example",
  "field": "example",
  "message": "example",
  "severity": "example"
}

401

Missing or invalid authentication

Media type application/json

object

code

string

error

string

field

string

message

string

severity

string

Example ^generated

{
  "code": "example",
  "error": "example",
  "field": "example",
  "message": "example",
  "severity": "example"
}

403

Not a member of this tenant

Media type application/json

object

code

string

error

string

field

string

message

string

severity

string

Example ^generated

{
  "code": "example",
  "error": "example",
  "field": "example",
  "message": "example",
  "severity": "example"
}

404

Cluster not found

Media type application/json

object

code

string

error

string

field

string

message

string

severity

string

Example ^generated

{
  "code": "example",
  "error": "example",
  "field": "example",
  "message": "example",
  "severity": "example"
}

429

Rate limit exceeded

Media type application/json

object

code

string

error

string

field

string

message

string

severity

string

Example ^generated

{
  "code": "example",
  "error": "example",
  "field": "example",
  "message": "example",
  "severity": "example"
}

503

Cluster is not yet ready

Media type application/json

object

code

string

error

string

field

string

message

string

severity

string

Example ^generated

{
  "code": "example",
  "error": "example",
  "field": "example",
  "message": "example",
  "severity": "example"
}