Skip to main content
POST
Elevate your own cluster access

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

authorization
string | null
x-ankra-organisation-id
string | null

Path Parameters

cluster_id
string<uuid4>
required

Body

application/json
role
enum<string>
required
Available options:
view,
edit,
admin,
cluster-admin
expires_in
string | null

Relative window: a duration such as 30m or 4h. Mutually exclusive with expires_at; one of the two is required.

expires_at
string<date-time> | null

Absolute expiry (RFC 3339). Mutually exclusive with expires_in; one of the two is required.

reason
string | null

Why the access is needed; required, recorded on the grant, in the audit log and on the notification.

Required string length: 3 - 500
namespace
string | null
scope
enum<string>
default:cluster

The whole cluster (default) or one namespace.

Available options:
cluster,
namespace

Response

Successful Response

grant
ClusterAccessGrant · object
required