Emails

Verify email OTP

Submit OTP code to verify a new email address. If the address is the only sign-in of another account that holds nothing else, that empty account is closed and the address moves to this one. If that account holds data, the add is refused with email_taken and a message saying which account to sign in with — the message differs when this account is the empty one, telling the user to sign in to the other account and add the channel of this one from there. Only this code step combines accounts: the magic link in the same email adds an unowned address but refuses one that already signs in elsewhere.

post/api/v1/me/emails/add/{sessionId}/verify

Request

  • Base URL: https://api.proof.holdings
  • URL: https://api.proof.holdings/api/v1/me/emails/add/{sessionId}/verify
  • Auth: API key in cookie auth_token

Path parameters

sessionIdstring required

Auth session ID

Request body

codestring required

OTP verification code

Example request

{
  "code": "123456"
}

Response

Email verified

successboolean required
messagestring

Example response

{
  "success": true,
  "message": "Operation completed successfully"
}

Changes

No recorded changes to this operation across all 1 revision of this API.