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

FieldDescription
externalIdExternal auth identifier, used as the primary identity reference across the platform
firstName / lastNameDisplay name
emailPrimary email address

​
Member

FieldDescription
memberIdExternal auth identifier for this org membership
authLevelRole: owner · admin · manager · member
organization_idThe org this membership belongs to

​
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 /api/org/:orgId/members — list all members of an org
  • GET /api/org/:orgId/members/:memberId — get a specific member
  • PATCH /api/org/:orgId/members/:memberId — update role or profile fields