MFAService
Regenerate Recovery Codes
Rotate recovery codes after a fresh step-up check.
Method
POST
Path
/v1/auth/mfa/recovery-codes:regenerate
Visibility
Authentication
Session token
MFA Requirement
POST
/v1/auth/mfa/recovery-codes:regenerate Request
Testnet
curl --request POST \ \ --url 'https://api.testnet.polyester.com/v1/auth/mfa/recovery-codes:regenerate' \ --header 'Accept: */*' \ --header 'X-API-KEY-ID: YOUR_API_KEY_ID' \ --header 'X-API-TIMESTAMP: YOUR_API_TIMESTAMP' \ --header 'X-API-SIGNATURE: YOUR_API_SIGNATURE'
Responses
{
"recoveryCodes": [
"POLY-7H2K-9M4Q"
]
} recoveryCodes string[]
New one-time recovery codes. Store these securely; they are only returned in this response.
Example
["POLY-7H2K-9M4Q"]| Key | HTTP status | Connect code | Error | When |
|---|---|---|---|---|
| unauthenticated | 401 | unauthenticated | Unauthenticated | Authentication required. |
| permission-denied | 403 | permission_denied | Permission Denied | Permission denied. |
| invalid-argument | 400 | invalid_argument | Invalid Argument | Invalid argument. |
| not-found | 404 | not_found | Not Found | Not found. |
| unavailable | 503 | unavailable | Unavailable | Service unavailable. |