Rotacionar o conjunto de chaves de tokenização de uma instituição
Dispara uma rotação manual do conjunto de chaves de tokenização (adiciona uma nova chave PRF primária) para a instituição endereçada. Uma rotação contenciosa na mesma instituição ou um conflito de concorrência otimista por versão desatualizada mapeia para 409; uma instituição sem conjunto de chaves ativo mapeia para 422; uma rotação confirmada mas não auditada mapeia para 500 (não repetível; escalar).
Autorizações
JWT bearer token issued by the identity provider.
Parâmetros de caminho
The institution's unique identifier (UUID) the keyset rotation targets.
"44444444-4444-4444-4444-444444444444"
Corpo
Optional operator-supplied free-text reason for the rotation (sealed verbatim into the audit payload).
"quarterly_keyset_rotation"
Resposta
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"

