Sign in anonymously
POST/auth/users/anonymous
Issue an end-user identity to a device without email, password, OAuth, or any other credential. Idempotent per (application, environment, device_id): repeated calls with the same device_id return the same user but a fresh token pair. Prior sessions for the user remain valid until natural expiry.
Anonymous users do not count toward MAU quota until their first authenticated request after sign-in (excluding /v1/auth/refresh).
Convert an anonymous user to a full account via POST /v1/auth/users/convert.
Pass an optional organization_id to create the anonymous user directly
in an organization; the returned access token then carries org_id
(and orgs), matching the org-scoped register/login flow.
Request
Responses
- 200
- 201
- 400
- 403
- 429
- 500
Anonymous user returned (existing device); fresh tokens issued
Anonymous user created; tokens issued
Validation error or missing environment context
Test environment user limit exceeded, or organization_id does not exist in this environment (code not_a_member_of_organization)
Rate limit exceeded
Internal server error