Complete Account Recovery

Completes a recovery you started with completed: false: the account goes from RECOVERING to NORMAL, and Koin updates last_recovered_at and recovery_count. completed only accepts true. client_flow and reported_by were set when you created the recovery and do not change. There is no bulk version.

  • On a recovery that is already completed it returns 200, so you can retry after a timeout.
  • On an expired recovery it returns 409 with EXPIRED: an abandoned recovery stays abandoned. If your analyst did finish the recovery, record it with a POST with completed: true.
  • On a recovery interrupted by a block it returns 409.
  • With a recovery_id that does not exist for that account it returns 404.
Path Params
string
required

The account's user_id: the same details.user_id you send on evaluations. URL-encode it if it contains reserved characters.

string
required

The recovery_id returned when you created the recovery.

Body Params
boolean
enum
required

Only accepts true; false returns 400.

Allowed:
boolean

You revoked the sessions and tokens of the account. Koin records it; it does not verify it.

string

Free text.

Responses

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json