two_factor

Replace recovery codes

Replaces a saved login's two-factor recovery codes. Saved codes are never shown again, only counted. The codes pass through this client and its model provider, so warn the user first.

put/v1/logins/{id}/recovery-codes

Request

  • Base URL: https://api.pomerado.ai
  • URL: https://api.pomerado.ai/v1/logins/{id}/recovery-codes
  • Auth: HTTP bearer

Path parameters

idstring required
Example:login_0f8e2d1c4b3a49e8a7f6e5d4c3b2a190

a saved login ID: login_ and 32 lowercase hex digits

Request body

codesstring[] required

an array of at most 20 item(s)

Response

The login

idstring required

a saved login ID: login_ and 32 lowercase hex digits

labelstring nullable required
username_maskedstring required
identifier_type'username' | 'email' | 'phone' | 'account_number' required
sign_in'password' | 'code' required
saved_fieldsstring[] nullable required

What it holds besides its username and password; null when not recorded

status'unverified' | 'verified' | 'needs_attention' required
lockedboolean required

Personal accounts: its identity is fixed after the first verified sign-in

your_access'use' | 'edit' | 'manage' required

use: run and build with it. edit: also reveal and change it. manage: also share and delete it

created_atstring required

When it was saved, ISO 8601 UTC

updated_atstring required

When it last changed, ISO 8601 UTC

verified_atstring nullable required

Its first verified sign-in, ISO 8601 UTC; null before one

Example response

{
  "id": "login_0f8e2d1c4b3a49e8a7f6e5d4c3b2a190"
}

Changes

No recorded changes to this operation across all 1 revision of this API.