403 Forbidden

PIN locked; a manager must reset it

Code

staff_pin_locked

Status

403 Forbidden

Type

https://errors.clavian.io/staff-pin-locked

What it means

The staff member’s PIN at this venue is locked after five wrong tries.

What to do

Ask a manager to reset the PIN. Trying again does not unlock it.

Example

The API answers with status 403 and this body, as application/problem+json. A detail may be added, saying what went wrong this time; it is for people, and changes.

{
  "type": "https://errors.clavian.io/staff-pin-locked",
  "title": "PIN locked; a manager must reset it",
  "status": 403,
  "code": "staff_pin_locked",
  "requestId": "req_01k5znw4hmfay8vvr14d2pf2db"
}

Endpoints that return it

From the OpenAPI document, every endpoint that names it among its answers:

• PUT /v1/organizations/{organizationId}/members/me/pinSet or change your own staff PIN at a venue
• POST /v1/organizations/{organizationId}/members/{memberId}/unlockUnlock this counter device as a member, with their PIN