Skip to content

Invalid Material Transition

URI: https://docs.ankatech.co/errors/material-status-invalid-transition
HTTP Status: 422 Unprocessable Entity

When you see this

The requested status change for this key material version is not allowed from its current material status.

Common Causes

  • Moving a key material version to a status that is unreachable from its current one.
  • Activating or destroying material in a status that forbids the change.
  • A transition that violates the key-material lifecycle rules.

Response Example

{
  "type": "https://docs.ankatech.co/errors/material-status-invalid-transition",
  "title": "Invalid Material Transition",
  "status": 422,
  "detail": "Key material cannot transition from 'DESTROYED' to 'ACTIVE'.",
  "instance": "/api/v3/admin/keys/my-mlkem-key/materials/2/status",
  "correlationId": "550e8400-e29b-41d4-a716-446655440000",
  "timestamp": 1730000000
}

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

How to Resolve

  1. Inspect the material version's current status before requesting a change.
  2. Request only transitions the material lifecycle permits from the current status.
  3. For destroyed or terminal material, provision a new material version instead.

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