> ## 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.

# Organizations

> Tenant accounts and member management.

An **Organization** is the top-level tenant in Holos. All resources (skills, captures, objects, courses) are scoped to an org. Members belong to an org with a specific role that determines what they can do.

## Roles

| Role      | Capabilities                                                            |
| --------- | ----------------------------------------------------------------------- |
| `owner`   | Full access including billing and ownership transfer                    |
| `admin`   | Full access to all resources; can manage members                        |
| `manager` | Can create and edit skills, captures, and objects; can approve captures |
| `member`  | Can view resources and record captures                                  |

Role assignment is managed through the Holos dashboard or via Stytch's B2B member management.

## SSO and SCIM

Organizations can configure SSO (SAML or OIDC) and SCIM provisioning via Stytch. When SCIM is active, member provisioning and deprovisioning is handled automatically by your identity provider.

## Key fields

| Field     | Description                           |
| --------- | ------------------------------------- |
| `orgId`   | Unique org identifier (slug)          |
| `name`    | Display name                          |
| `slug`    | URL-safe identifier used in API paths |
| `members` | List of member records with roles     |

## Endpoints

* `GET /api/org/:orgId` — get organization details
* `GET /api/org/:orgId/members` — list members
* `POST /api/org/:orgId/members/invite` — invite a new member
* `PATCH /api/org/:orgId/members/:memberId` — update a member's role
* `DELETE /api/org/:orgId/members/:memberId` — remove a member
