Auth Start

Start authentication: verify TEE signature, then send OTP to email.

POST /api/v1/auth/start

Auth Start

cURL

curl --request POST \
  --url https://api.hevn.finance/api/v1/auth/start \
  --header 'Content-Type: application/json' \
  --data '
{
  "email": "<string>"
}
'

200

{
  "sessionKey": "<string>",
  "status": "pending",
  "authMethods": []
}

Headers

device-id · string | null

user-agent · string | null

Body

application/json

Request schema for starting authentication.

email · string · required

User email address

Response

200

application/json

Successful Response

Response schema for auth start.

sessionKey · string · required

Session key for OTP verification

status · string · default: pending

Auth session status

authMethods · enum<string>[]

Required auth methods

Available options: email_otp, totp, signed_jwt