> ## Documentation Index
> Fetch the complete documentation index at: https://docs.akua.dev/llms.txt
> Use this file to discover all available pages before exploring further.
# Organizations
> Give your company a shared identity, centralized member management, and the ability to manage customer workspaces on their behalf
An organization represents your company in Akua. It gives your team a shared identity, centralized member management, and the ability to manage customer workspaces on their behalf.
Every workspace belongs to an organization. During onboarding, Akua creates the first organization automatically so individual users and small teams can start in a workspace without thinking about company setup. As the team grows, the same organization becomes the place to manage members, customer workspace access, and shared identity.
## What organizations enable
### Sell and manage software for your customers
If you build software that your customers install through Akua, organizations let you manage those customer installations. Your team gets admin access to customer workspaces, so you can ship 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
Set up an organization for your company with a name and optional slug.
Add team members with roles: owner, admin, or member. Everyone in the organization shares the same access to managed workspaces.
When a customer grants your organization access to their workspace (through an Offer or workspace settings), all your team members automatically get admin access.
## Managed workspaces
When a workspace is linked to your organization:
* 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
| 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.
Endpoints, parameters, response shapes, try-it playground.
Mint API tokens for programmatic access.
## Related topics
Workspace roles and member management.
Set up API tokens for programmatic access.
Compare plans and understand workspace limits.
How Akua isolates workloads and protects data.