PropperDocs

New recovery codes

.md

Replace every recovery code with a new set.

Scopesme:write
POST/v1/me/two-factor/recovery-codes

A new set of recovery codes. The old ones stop working at once, wherever they were written down.

Request

curl -X POST https://api.proppertrading.com/v1/me/two-factor/recovery-codes \
  -H "Authorization: Bearer ptat_9f2c1a44_3b8e7d2f5c9a1b4e6d8f0a2c4e6b8d1f" \
  -H "Idempotency-Key: 5b7d9f1a-3c5e-4b8d-a0c2-4e6a8c0e2b4d"

No body.

Response

201, with the new codes in the shape of your recovery codes.

Errors

StatusCodeMeaning
400two_factor_not_enabledThe account has no authenticator, so no codes
403insufficient_scopeThis device does not hold me:write