> ## Documentation Index
> Fetch the complete documentation index at: https://docs.holos.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Users & Members

> User identity and org membership in Holos.

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

| Field                    | Description                                                                          |
| ------------------------ | ------------------------------------------------------------------------------------ |
| `externalId`             | External auth identifier, used as the primary identity reference across the platform |
| `firstName` / `lastName` | Display name                                                                         |
| `email`                  | Primary email address                                                                |

### Member

| Field             | Description                                      |
| ----------------- | ------------------------------------------------ |
| `memberId`        | External auth identifier for this org membership |
| `authLevel`       | Role: `owner` · `admin` · `manager` · `member`   |
| `organization_id` | The 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