Skip to content

Organizations and workspaces

An organization is your company’s account in Aethis. It holds:

  • Members and their organization roles
  • Roles & Permissions, including custom roles
  • Workspaces
  • organization-wide Policies and governance defaults
  • SSO and security settings

You can belong to more than one organization. Switch between them with the organization switcher at the top left of the dashboard.

When you invite someone, you choose their Organization Role and Initial Workspace. The built-in roles are:

Role Typical use
Owner The account owner. Has access to all workspaces.
Organization Admin Manages members, workspaces, credentials and security.
Reviewer Reviews actions in the Approval Queue for the workspaces they can access.
Member Works in the workspaces they are given access to.

Use Create Role under Roles & Permissions to define a narrower role, such as a reviewer for production only. Give people the minimum role they need.

A workspace is a separate operating environment inside an organization. Each workspace has an environment type (Production, Staging or Development) and its own:

  • Agents and their access keys
  • Connections and Model Routes
  • Policy assignments
  • Approval Queue, Activity and Alerts

Agents can only be assigned Connections from the same workspace, so a staging Agent can’t reach a production MCP server by accident. Keep production and non-production work in separate workspaces.

Switch workspaces with the workspace switcher in the top bar. Most of the dashboard shows the current workspace only.

A Policy scoped to the organization can apply across workspaces. An organization can offer it as Available, turn it on by default (Default On), or make it Required, in which case workspaces and Agents can’t detach it. See Policies and decisions.

To manage members and workspaces, see Manage your organization and workspaces.