USER MANUAL · SYSTEM

Organizations

Create and manage organizations with role-based access, member invitations, and org-scoped data isolation.

/organizations

Overview#

Organizations are the top-level governance boundary in ClawButler. Every agent, connector, cost record, and audit event belongs to an organization. Multi-org support means you can separate production from staging, isolate client environments, or delegate team-level autonomy — all from a single ClawButler account.

Each organization has its own member roster with role-based access control. Owners have full administrative authority, admins manage day-to-day operations, and members have read access with limited write permissions. Billing, subscriptions, and entitlements are scoped per organization, so usage and costs stay cleanly separated.

Prerequisites#

Prerequisites
  • A registered ClawButler user account
  • Team plan subscription for advanced features (shared budgets, batch approval, managed federation)

Expected Results#

After creating or joining an organization, you will see:

  • -Organization list in the sidebar switcher, showing all orgs you belong to with your role badge
  • -Member management panel with invite status, role assignments, and removal controls
  • -Role badges (Owner, Admin, Member) next to each member's name throughout the interface
  • -Organization settings page with name, billing information, and preference controls

Web Operations#

Organization management is accessible from the System section in the sidebar. Use the org switcher in the sidebar header to move between organizations.

Organization List

The sidebar org switcher shows all organizations you belong to. Click the current org name to expand the list and switch contexts. To create a new organization, click the Create button at the bottom of the switcher. Each entry displays the org name and your role within it.

Member Management

Navigate to Organizations > Members to view the full member roster. From here you can invite new members by email, assign or change roles (owner, admin, member), and remove members who no longer need access. Pending invitations show an 'invited' badge until the recipient accepts.

Roles & Permissions

ClawButler uses three roles with escalating privileges:

  • -Owner — Full control including billing, subscription management, org deletion, and ownership transfer. Each org must have at least one owner.
  • -Admin — Can manage members, connectors, agents, and operational settings. Cannot modify billing or delete the organization.
  • -Member — Read access to all org data. Can perform day-to-day operations (approve requests, view costs, browse audit logs) but cannot invite members or change settings.

Organization Settings

The Settings tab lets owners and admins update the organization name, configure billing preferences, and manage subscription entitlements. Team plan features — shared budgets, batch approval workflows, and managed federation — are enabled here when the subscription is active.

CLI Operations#

List all organizations you belong to with your role in each

Terminal
$ ap org list

Create a new organization with the specified name

Terminal
$ ap org create --name "My Team"

List all members in the current organization with their roles

Terminal
$ ap org members

Invite a new member by email address

Terminal
$ ap org invite --email [email protected]

FAQ#

Q: How many organizations can I create?
A: Free plan users can create one organization. Pro and Team plan subscribers can create unlimited organizations. Each organization operates as a fully isolated workspace with its own data, members, and billing.
Q: What's the difference between Owner, Admin, and Member roles?
A: Owners have full control including billing and org deletion. Admins can manage members, connectors, and operational settings but cannot touch billing. Members have read access and can perform daily operations (approvals, cost viewing, audit browsing) but cannot change settings or invite others.
Q: Can I transfer organization ownership?
A: Yes. An owner can transfer ownership to any existing admin or member from the Organization Settings page. The transfer promotes the target user to owner. The original owner is downgraded to admin. Each organization must always have at least one owner.
Organizations — ClawButler User Manual