Rotar el conjunto de claves de tokenización de una institución
Dispara una rotación manual del conjunto de claves (keyset) de tokenización (añade una nueva clave PRF primaria) para la institución direccionada. Una rotación en contención sobre la misma institución o un conflicto de concurrencia optimista por versión obsoleta se mapea a 409; una institución sin keyset activo se mapea a 422; una rotación confirmada pero no auditada se mapea a 500 (no reintentable; escalar).
Autorizaciones
JWT bearer token issued by the identity provider.
Parámetros de ruta
The institution's unique identifier (UUID) the keyset rotation targets.
"44444444-4444-4444-4444-444444444444"
Cuerpo
Optional operator-supplied free-text reason for the rotation (sealed verbatim into the audit payload).
"quarterly_keyset_rotation"
Respuesta
OK
The institution the rotation targeted.
"44444444-4444-4444-4444-444444444444"
The newly active tokenization-keyset version.
3
The tokenization-keyset version that was active before the rotation.
2
The RFC3339 timestamp the rotation committed.
"2026-06-08T12:00:00Z"

