post
https://api-sandbox.koin.com.br/v1/accounts//recoveries
Starts a recovery, or records one that already finished. Allowed from BLOCKED and QUARANTINED.
completed: false(default), self-service in two steps: the account becomesRECOVERINGuntilexpires_at. The events of your recovery flow (for example, theCHANGE_PASSWORDof the reset) pass with strong verification instead of being denied. When you are sure the user recovered the account, complete it withPATCH /v1/accounts/USER_ID/recoveries/{recovery_id}. Ifexpires_atpasses first, the recovery is abandoned and the account gets a new restriction of the same kind it had before.completed: true, call center in one step: the account stayedBLOCKEDduring your review and becomesNORMAL.
Reaching NORMAL updates last_recovered_at and recovery_count. If a block was a mistake, recover the account with client_flow: FALSE_POSITIVE.
Special cases:
completed: falseon an account that is alreadyRECOVERINGreturns 200 with the same recovery in progress (the samerecovery_id) and renewsexpires_at, with the value you sent or the default period.completed: trueon an account that isRECOVERINGreturns 409: complete the recovery in progress with the PATCH.- On a
NORMALaccount it returns 409 if the user never went through a recovery, because there is nothing to recover. If they did (for example, you retry after a timeout), it returns 200 with that recovery.
