Error
Users
Create (or refresh) the verified caller's user record.
Creates the users row for the authenticated wallet. The address is taken from the verified session, never the body, so a caller can only ever create their own record. A referrer is captured once on first creation and only if it exists and differs from the caller. Idempotent.
POST
Error
Authorizations
HttpOnly session cookie set by POST /v1/auth/session. Mutating requests must also send the CSRF token (returned by that call) in the x-csrf-token header.
Body
application/json
Optional referrer wallet. Ignored if it equals the caller or does not exist.
Required string length:
30 - 80Pattern:
^[123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz:]+$Response
Default Response
Last modified on August 11, 2026

