Return information about the caller

GET

/auth/me

• Local development behind nginx (port 8088 by default)

Authorizations

• cookieAuth
• bearerAuth

Responses

200

Current user

object

ref

required

integer format: int64

username

required

string

fullname

string

nullable

email

string

nullable

usergroup

integer format: int64

nullable

auth_method

required

How the caller was authenticated for this request.

string

Allowed values: session token

language

User’s language pref (BCP47). Empty string = follow system / browser. Joined from user_profiles at /auth/me time so the frontend can hydrate the language store on first paint without a separate round-trip.

string

theme

User’s theme pref. Empty string = follow system. Same “join on /auth/me” rationale as language.

string

Allowed values: "" light dark

impersonated_by

Non-null when the session was minted via POST /admin/users/{ref}/impersonate. Carries the acting admin’s ref + username so the persistent “you are acting as @target” banner can render without a separate round-trip.

object

ref

required

integer format: int64

username

required

string

401

Authentication required, missing, or invalid

object

error

required

Human-readable error summary

string

Example

the request could not be completed

Example

{
  "error": "authentication required: sign in and retry with a valid session or API token"
}