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

# Organizations

> Manage your team and customer relationships across multiple workspaces

An organization represents your company in CNAP. It gives your team a shared identity, centralized member management, and the ability to manage customer workspaces on their behalf.

Organizations are optional. Individual users and small teams can use workspaces directly without creating one.

## What organizations enable

### Sell and manage software for your customers

If you build software that your customers deploy through CNAP, organizations let you manage those deployments. Your team gets admin access to customer workspaces, so you can deploy updates, monitor health, and troubleshoot issues — all while the customer retains ownership and billing control.

### Centralized team access

Add a team member to your organization once, and they automatically get access to every workspace your organization manages. When someone leaves, removing them from the organization revokes access everywhere — no need to update each workspace individually.

### Customer-first ownership model

Your customers always own their workspaces. They control billing, can add their own team members, and can revoke your access at any time. Your organization gets scoped admin access to their specific workspace, not their entire account.

## How it works

<Steps>
  <Step title="Create your organization">
    Set up an organization for your company with a name and optional slug.
  </Step>

  <Step title="Invite your team">
    Add team members with roles: owner, admin, or member. Everyone in the organization shares the same access to managed workspaces.
  </Step>

  <Step title="Manage customer workspaces">
    When a customer grants your organization access to their workspace (through an install link or workspace settings), all your team members automatically get admin access.
  </Step>
</Steps>

## Managed workspaces

When a workspace is linked to your organization through the `managedBy` relationship:

* All organization members get **admin** access to the workspace
* The workspace owner retains full control, including billing and deletion
* The workspace owner can revoke your access at any time

<Info>
  Managed workspaces appear separately in the sidebar under "Shared With Me", keeping your own workspaces distinct from customer workspaces you manage.
</Info>

## Organization roles

| Role       | What they can do                                                  |
| ---------- | ----------------------------------------------------------------- |
| **Owner**  | Full control — delete organization, manage roles, update settings |
| **Admin**  | Manage members, update organization settings                      |
| **Member** | Access all managed customer workspaces with admin permissions     |

## API

Manage organizations programmatically through the REST API:

```bash theme={null}
# Create an organization
curl -X POST https://api.cnap.tech/v1/organizations \
  -H "Authorization: Bearer cnap_pat_..." \
  -d '{"name": "Acme Corp", "slug": "acme"}'

# List your organizations
curl https://api.cnap.tech/v1/organizations \
  -H "Authorization: Bearer cnap_pat_..."

# Add a team member
curl -X POST https://api.cnap.tech/v1/organizations/org-id/members \
  -H "Authorization: Bearer cnap_pat_..." \
  -d '{"user_id": "user-id", "role": "admin"}'

# See all customer workspaces you manage
curl https://api.cnap.tech/v1/organizations/org-id/workspaces \
  -H "Authorization: Bearer cnap_pat_..."
```

<Card title="API Reference" icon="flask" href="https://api.cnap.tech/v1/docs">
  See the full Organizations API in the interactive reference
</Card>

## Related topics

* [Workspaces →](/workspaces) — Understand workspace roles and member management
* [Authentication →](/apis/authentication) — Set up API tokens for programmatic access