Skip to content

Issue a short-lived shoot-admin kubeconfig

POST
/api/v1/teams/{team_slug}/clusters/{name}/kubeconfig/
curl --request POST \
--url https://example.com/api/v1/teams/example/clusters/example/kubeconfig/ \
--header 'Content-Type: application/json' \
--cookie sessionid=<sessionid> \
--data '{ "ttlSeconds": 1 }'

Issue a short-lived shoot-admin kubeconfig (docs/58 §5.7) — the only management-style credential a customer receives, scoped to this one Shoot. Never stored; audited.

name
required
string
team_slug
required
string
object
ttlSeconds

≤ 8h; default 1h (docs/58 §5.7)

integer
Example generated
{
"ttlSeconds": 1
}
Media type application/json

A short-lived shoot-admin kubeconfig (docs/58 §5.7) — never stored, audited on issue.

object
kubeconfig
required
string
expiresAt
required
string format: date-time
scope
required
string
Example generated
{
"kubeconfig": "example",
"expiresAt": "2026-04-15T12:00:00Z",
"scope": "example"
}

RFC 7807 problem document

Media type application/json

RFC 7807 application/problem+json — every non-2xx response (docs/58 §5.10).

object
type
required
string format: uri
title
required
string
status
required
integer
detail
required
string
code
required

Stable machine code clients switch on

string
instance
required
string
nullable
operationId
required
string
nullable
Example generated
{
"type": "https://example.com",
"title": "example",
"status": 1,
"detail": "example",
"code": "example",
"instance": "example",
"operationId": "example"
}

RFC 7807 problem document

Media type application/json

RFC 7807 application/problem+json — every non-2xx response (docs/58 §5.10).

object
type
required
string format: uri
title
required
string
status
required
integer
detail
required
string
code
required

Stable machine code clients switch on

string
instance
required
string
nullable
operationId
required
string
nullable
Example generated
{
"type": "https://example.com",
"title": "example",
"status": 1,
"detail": "example",
"code": "example",
"instance": "example",
"operationId": "example"
}