Set or change an operator's transaction PIN
Deprecated on 2026-10-07. Use PUT /v1/people/pin. This alias keeps the
same request and the same response (status set or changed) and
writes the person’s PIN. The account is only how the tenant is resolved.
The PIN belongs to the operator (actingDocument) inside the
tenant, not to the account. Changing an existing PIN requires
currentPin. Requires scope pin.manage. The PIN is stored as an
argon2id hash and never appears in a response or a log.
When hosted reset is on, a replacement without currentPin returns
403 pin_change_disabled. A replacement with the correct
currentPin still succeeds. The first enrollment does not need
currentPin. After DELETE, a PUT without currentPin re-enrolls
only while hosted reset is off — that is the internet-banking reset.
Authentication
Bearer authentication of the form Bearer <token>, where token is your auth token.
Path parameters
Headers
Optional client-generated idempotency token (recommended for safe retries).