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.

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 Akua, 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:

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

API reference

Endpoints, parameters, response shapes, try-it playground.

Authentication

Mint API tokens for programmatic access.

Related topics

Workspaces

Workspace roles and member management.

Authentication

Set up API tokens for programmatic access.

Plans and pricing

Compare plans and understand workspace limits.

Security

How Akua isolates workloads and protects data.