Skip to main content
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

1

Create your organization

Set up an organization for your company with a name and optional slug.
2

Invite your team

Add team members with roles: owner, admin, or member. Everyone in the organization shares the same access to managed workspaces.
3

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.

​
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
Managed workspaces appear separately in the sidebar under “Shared With Me”, keeping your own workspaces distinct from customer workspaces you manage.

​
Organization roles

RoleWhat they can do
OwnerFull control — delete organization, manage roles, update settings
AdminManage members, update organization settings
MemberAccess all managed customer workspaces with admin permissions

​
API

Manage organizations programmatically through the REST API: 
# 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_..."

API Reference

See the full Organizations API in the interactive reference