Read the current user and Workspace
Read the current user and Workspace
/api/v1/meReturns the authenticated user and, when selected, the session's current Workspace, the caller's Actor within it, and their role. A newly registered account-only session omits the Workspace fields. Native bearer requests return the account-only projection and never inherit a browser session's selected Workspace. Upcoming interface_language_state uses bounded Accept-Language for this read, then the current credential hint when absent. Reading never persists a background-delivery hint.
Header Parameters
stringUpcoming browser-session canonical read custody. The named private scope captures this response and a signed replay cursor in one snapshot. Successful responses include X-Assign-Realtime-Cursor and X-Assign-Realtime-Position. Apply all required retained state before acknowledging the corresponding socket checkpoint. Failed or incomplete baselines return no cursor.
accountaccount_securityResponses
string·const no-storePrevents storage of error responses by clients and intermediaries.
stringQuoted decimal optimistic-concurrency version.
string·max 4096Signed scope/User/session-bound replay custody; only when the requested canonical baseline succeeds.
stringDecimal-string snapshot position; only with a successful baseline cursor.
objectUpcoming. Core-qualified presentation language. Desired Account preference wins; Automatic matches ordered device languages through finite aliases, then falls back to English. Unavailable stored preferences are retained and resolve safely to English.
string <uuid>Opaque Assign-owned UUIDv7 identifier. Clients must not derive meaning from it.
string·min 3·max 30Globally unique mutable public account handle. New handles use lowercase letters, numbers, and interior dots and are initially derived from the email local part. Existing hyphen/underscore handles remain readable. Previously claimed values remain reserved to the same User.
string·max 2048HTTPS legacy URL or authenticated stable API content path for an S3-hosted picture.
string·min 1·max 2Account-owned avatar letters override; null derives letters from the display name.
string·max 11Account-owned avatar background, a random family name at registration; null predates AVATAR-001.
booleanWhen true, timezone is the effective value from the current Workspace default.
string·min 1·max 35·default automaticDesired Account interface language, independent of regional locale and Workspace defaults. Older servers may omit this field; clients use automatic. Withdrawn languages may remain stored.
booleanWhen true, locale is the effective value from the current Workspace default.
booleanTrue only when the current account has a confirmed TOTP authenticator credential.
stringAccount-wide presentation preference for contextual or always-visible formatting controls across every editor host.
contextualpersistentbooleanWhen true, first_day_of_week is the effective value from the current Workspace default.
string <uuid>Opaque Assign-owned UUIDv7 identifier. Clients must not derive meaning from it.
integer·min 0Delay in seconds before retrying, when an expected maintenance end is known.
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·min 1·max 200Correlation identifier for the request.
string·const nosniffPrevents user agents from MIME-sniffing the response.