Initiate account recovery

POST

/api/v1/recovery/initiate

curl --request POST \
  --url http://localhost:3001/api/v1/recovery/initiate \
  --header 'Content-Type: application/json' \
  --data '{ "backup_code": "example", "new_wallet_address": "example", "new_wallet_signature": "example", "nonce": "example", "old_wallet_address": "example", "recovery_method": "example" }'

• Local development
• Production

Start recovery process via social guardians or backup codes

Request Body^required

Recovery initiation details

Media typeapplication/json

object

backup_code

string

new_wallet_address

string

new_wallet_signature

string

nonce

string

old_wallet_address

string

recovery_method

string

Example^generated

{
  "backup_code": "example",
  "new_wallet_address": "example",
  "new_wallet_signature": "example",
  "nonce": "example",
  "old_wallet_address": "example",
  "recovery_method": "example"
}

Responses

200

OK

Media typeapplication/json

object

expires_at

string

message

string

request_id

string

success

boolean

time_lock_until

string

Example^generated

{
  "expires_at": "example",
  "message": "example",
  "request_id": "example",
  "success": true,
  "time_lock_until": "example"
}

400

Bad Request

Media typeapplication/json

object

error

string

success

boolean

Example^generated

{
  "error": "example",
  "success": true
}

401

Unauthorized

Media typeapplication/json

object

error

string

success

boolean

Example^generated

{
  "error": "example",
  "success": true
}

403

Forbidden

Media typeapplication/json

object

error

string

success

boolean

Example^generated

{
  "error": "example",
  "success": true
}

404

Not Found

Media typeapplication/json

object

error

string

success

boolean

Example^generated

{
  "error": "example",
  "success": true
}

500

Internal Server Error

Media typeapplication/json

object

error

string

success

boolean

Example^generated

{
  "error": "example",
  "success": true
}