Verify anonymous-login challenge and create or resume an anonymous session.

POST

/api/auth/anon-login/verify

Code sample: Shell / cURL

curl --request POST \
  --url https://auth.example.com/api/auth/anon-login/verify \
  --header 'Content-Type: application/json' \
  --data '{ "challenge_id": "challenge_123", "device_signature": "device_sig_123", "proof": "signed_challenge" }'

Request Body ^required

Media type application/json

object

challenge_id

required

string

device_signature

required

string

proof

string

Example

{
  "challenge_id": "challenge_123",
  "device_signature": "device_sig_123",
  "proof": "signed_challenge"
}

Responses

200

Successful JSON response.

Media type application/json

object

success

required

boolean

session_id

required

string

user_id

required

string

is_new_user

required

boolean

upgrade_eligible

required

boolean

user

required

object

id

string

user_type

string

Example

{
  "success": true,
  "session_id": "sess_123",
  "user_id": "anon_123",
  "is_new_user": true,
  "upgrade_eligible": true,
  "user": {
    "id": "anon_123",
    "user_type": "anonymous"
  }
}