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 | Status | Error | When |
|---|---|---|---|
| unauthenticated | 401 | Unauthenticated | Authentication required. |
| permission-denied | 403 | Permission Denied | Permission denied. |
| invalid-argument | 400 | Invalid Argument | Invalid argument. |
| not-found | 404 | Not Found | Not found. |
| unavailable | 503 | Unavailable | Service unavailable. |