Rotate or restore a managed tier's backend credential (platform)

Updates the credential an ANKA-managed tier uses to authenticate to its key-protection backend. Exactly one of two actions per request: supply a candidate credential to ROTATE, or set restorePrevious to put back the credential the last rotation superseded. A rotation is proved before it lands by a CROSS-CREDENTIAL round trip: an ephemeral key is wrapped under the credential currently in effect and unwrapped under the candidate, so only a candidate that reaches the SAME key-encryption key is accepted. A candidate that is individually valid but reaches a different key is refused 422 with the previous credential unchanged and still in effect — which is what stops a credential swap silently relocating custody and making existing material unreadable. The superseded credential stays restorable for a bounded, audited retention window; past it the retained value is purged and a restore is refused. A tier whose backend takes no console-managed credential is refused 422 before anything is verified or written. The credential is never returned, logged or audited. Required scope: admin.platform.key-backend.tier.manage.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
enum
required

The licensed tier whose credential to update.

Allowed:
Body Params

Updates an ANKA-managed tier's key-protection backend credential — either rotating to a supplied candidate (validated by a cross-credential wrap/unwrap round trip before the swap) or restoring the credential the last rotation superseded, within its bounded retention window. Exactly one of the two.

credential

The candidate structured, per-provider write-only backend credential (never returned, logged, or audited). Omit when restorePrevious is true.

boolean
Defaults to false

Restore the credential superseded by the last rotation, within its bounded retention window. Omit (or false) when supplying a candidate credential.

Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Language
Credentials
Bearer
JWT
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
application/problem+json