auth.v1.MFAService
RegenerateRecoveryCodes
Rotate the caller's recovery codes.
Method
POST
Path
auth.v1.MFAService/RegenerateRecoveryCodes
Service
auth.v1.MFAService
Visibility
Authentication
Session token
MFA Requirement
POST
auth.v1.MFAService/RegenerateRecoveryCodes Request
Testnet
curl --request POST \ \
--url 'https://api.testnet.polyester.com/auth.v1.MFAService/RegenerateRecoveryCodes' \
--header 'Content-Type: application/json' \
--header 'Connect-Protocol-Version: 1' \
--data '{}'Responses
{
"recoveryCodes": [
"POLY-7H2K-9M4Q"
]
}Request
auth.v1.RegenerateRecoveryCodesRequestResponse
auth.v1.RegenerateRecoveryCodesResponse recoveryCodes string[]
New one-time recovery codes. Store these securely; they are only returned in this response.
| 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. |