Skip to main content

Verify an approval OTP

POST 

/approvals/otp/verify

Exchanges the code the approver received for an approval_token, with the same rules as POST /approvals/pin. This call takes no Idempotency-Key.

  • Wrong codes share the 3 tries and the 15 minute lock of the PIN check.

Errors​

StatusCodeWhen
400VALIDATION_FAILEDThe body is not valid.
400USER_ID_REQUIREDX-User-ID is missing.
403OTP_INVALIDA wrong code; see data.attempts_remaining.
403OTP_EXPIREDThe code expired, or the request_id is unknown or belongs to another user.
403PERMISSION_DENIEDThe acting user may not do this.
403OUTLET_FORBIDDENThe outlet is not allowed.
409PIN_LOCKEDThe shared lock is on; see data.unlock_at.
409SHIFT_NOT_OPENThe acting user has no open shift.
422INVALID_USERThe acting user is not valid.

Request​

Responses​

The approval grant