Skip to content

Tier Credential Restore Unavailable

URI: https://docs.ankatech.co/errors/tier-credential-restore-unavailable
HTTP Status: 422 Unprocessable Entity

When you see this

You asked to restore the credential that a managed tier's last rotation superseded, and there is nothing to put back. Either no rotation has been performed on this tier, or the bounded retention window for the superseded credential has elapsed — in which case the retained value is purged rather than merely refused, so the retention bound is real. This is distinct from a failed self-test: that one says the candidate is wrong, this one says there is no previous credential left.

Common Causes

  • restorePrevious was requested on a tier that has never had its credential rotated.
  • The retention window for the superseded credential has elapsed and the retained value was purged.
  • restorePrevious was requested while the tier's first credential was still being established, where there is no previous credential by definition.

Response Example

{
  "type": "https://docs.ankatech.co/errors/tier-credential-restore-unavailable",
  "title": "Tier Credential Restore Unavailable",
  "status": 422,
  "detail": "No previous credential is available to restore. The retention window for a superseded credential is bounded, and it has either elapsed or no rotation has been performed.",
  "instance": "/api/v3/admin/platform/key-backend/tiers/ENTERPRISE/credential",
  "timestamp": 1730000000,
  "extensions": {
    "requestId": "550e8400-e29b-41d4-a716-446655440000"
  }
}

Content-Type: application/problem+json — the response follows RFC 9457 Problem Details.

How to Resolve

  1. Do not retry the restore — there is nothing retained to restore, and the condition will not clear on its own.
  2. If the tier needs a different credential, rotate to it: supply a candidate credential rather than restorePrevious.
  3. Retrieve the credential you intended to restore from your own secret store, and submit it as a rotation candidate.

For full schema definitions, examples, and interactive testing, see the Developer Hub Reference.