Skip to main content
Holos distinguishes between Users (identity) and Members (org membership).

​
Users

A User represents an individual’s identity: their email address and display name. A user can belong to multiple organizations.

​
Members

A Member record links a User to an Organization with a specific role. Most API endpoints work with Member IDs rather than User IDs, since the meaningful context is always within an org.

​
Key fields

​
User

​
Member

​
Denormalized name fields

Some resources (Captures, Skills) store memberFirstName and memberLastName directly on the record. This is intentional; it ensures display names remain stable even if a user updates their profile after the fact.

​
Endpoints

  • GET /users/me: the caller’s own profile
  • GET /users/me/capabilities: what the caller is permitted to do
  • POST /users/exchange-session: bind a session to an organization
  • GET /organizations/{id}/members: list the members of an org