Sign in

v1

latestOpenAPI 3.1.02026-07-13143194365.4 KB
auth

Complete account recovery

Complete the account recovery flow by providing verification.

For email/SMS (cdp_otp):

  1. Complete CDP OTP verification for the recovery identity
  2. Provide the CDP token in cdp_token field

For wallet (signature):

  1. Sign the challenge message from recovery/start
  2. Provide the signature in signature field

On success:

  • Returns the Grove API key with the original primary identity subject
  • The primary identity remains unchanged (immutable primary design)
  • You regain full access to the account

Security Note: In the future, recovery will notify other verified identities.

post/v1/auth/recover/complete

Request body

recovery_tokenstring required

Signed session token from recovery/start

cdp_tokenstring nullable

CDP Auth token (for email/SMS recovery)

signaturestring nullable

Wallet signature (for wallet recovery)

Response

Successful Response

account_idstring required

Recovered account ID

api_keystring required

Grove API key (JWT)

identity_typestring required

Primary identity type

identity_valuestring required

Primary identity value

tipping_addressstring required

Server wallet address (for tipping)

recoveredboolean

Indicates this was a recovery

onchain_addressstring required