Identify the authenticated principal
Use when: caller wants a minimal “who am I” snapshot — typically a CLI / agent confirming the API key it loaded resolves to the expected Verlon account and tier
Returns the authenticated user’s id, email, tier, and the auth mode that resolved the request (api_key or session). When the auth mode is api_key, also returns apiKeyId so the caller can identify which of their keys was used. No PII beyond the email; intentionally a smaller surface than /v1/user (dashboard-only). Accepts both API key and session auth.
Authorizations
Verlon API key (newly minted keys are prefixed sk-vrln-; legacy verlon_* and layer_* keys from prior prefix migrations continue to validate). Generated from the dashboard under Settings → API Keys, or via verlon key create in the CLI.

