Who is calling: the user, the ledger the request acts in, their role
there, and whether this credential may write. Useful as a first call to
check a token works and what it can do.
Parameters
X-Organization-Id
string | null · header
Returns 200 · Me
can_write
boolean · required
Whether write operations will be allowed: a write-scoped credential and an editor role or above.
credential
string · required
token for an API token, oauth for an app the user connected with OAuth (an MCP client), session for a signed-in user.
organization_id
string · required
The ledger this request acts in (a UUID): a token's own ledger, else the X-Organization-Id header, else the user's personal ledger.
role
string · required
The user's role in that ledger: owner, admin, editor or viewer.
token_scope
string | null · required
read or write for a token; read or propose for an OAuth app (which never writes: with propose it proposes changes over MCP for the user to approve); null for a session.
user_id
string · required
The user's id (a UUID). A token acts as the user who made it.
Example
curl -X GET "https://api.lumaledger.app/v1/me" \
-H "Authorization: Bearer $LUMALEDGER_TOKEN"
Objects
Me
The caller, as this ledger sees them.
Fields
can_write
boolean · required
Whether write operations will be allowed: a write-scoped credential and an editor role or above.
credential
string · required
token for an API token, oauth for an app the user connected with OAuth (an MCP client), session for a signed-in user.
organization_id
string · required
The ledger this request acts in (a UUID): a token's own ledger, else the X-Organization-Id header, else the user's personal ledger.
role
string · required
The user's role in that ledger: owner, admin, editor or viewer.
token_scope
string | null · required
read or write for a token; read or propose for an OAuth app (which never writes: with propose it proposes changes over MCP for the user to approve); null for a session.
user_id
string · required
The user's id (a UUID). A token acts as the user who made it.
