Workspace Boundary

Organizations

Organizations are the top-level workspace boundary in ClawButler. The current surface focuses on selecting the active org, editing basic org metadata, and managing existing members.

/organizations

Overview#

Each organization is its own governance context. Switching organizations changes the workspace boundary for agents, connectors, approvals, costs, audit, and the other org-scoped operator surfaces.

The current Web page is intentionally narrower than older documentation. It supports selecting the current workspace, creating and editing orgs, listing members, adding an existing user by ID, changing member roles, and removing members.

Prerequisites#

Prerequisites

A user account that already has access to at least one organization, or permission to create one
Access to the Web console at `/organizations`

Expected Results#

On the current page, expect:

-An organization selector with a current-workspace badge
-A detail card for the selected organization with name, slug, description, and edit action
-A member table with add, role-change, and remove actions for existing users

Web Operations#

Use this page to manage the active workspace boundary, not to run a full identity-management product.

Select Current Workspace

Choose an organization from the selector, then use the workspace button to make it current. This changes the org context for the rest of the operator console.

Create Or Edit Organizations

You can create an organization with name and slug, then later edit name and description. The current Web form does not act as a full settings console for every org property.

Manage Members

The current Web flow adds existing users by user ID, not by email invitation. Owners remain fixed on the page; non-owner members can be promoted between admin and member or removed.

CLI Operations#

CLI exposes the same org boundary and member-management workflow:

Terminal

$ ap org list

Inspect the current organization context:

Terminal

$ ap org current

List members and add an existing user:

Terminal

$ ap org members <org-id>

Terminal

$ ap org add-member <org-id> --user-id <user-id> --role admin

FAQ#

Q: Can I invite a member by email from this page?

A: Not on the current Web surface. The add-member dialog expects an existing user ID, so this page is for workspace membership management rather than invitation flow.

Q: Can I edit the slug later?

A: Not from the current Web form. Creation captures the slug; later edits focus on name and description.

Q: Can I transfer ownership from this page?

A: The current retained Web surface does not expose an ownership-transfer flow. Treat the page as a focused workspace and member-management surface.