Skip to main content

Organization Structure

Revision allows organizations to have multiple workspaces with teams, with shared billing and security settings.

Organization​

An organization represents your company, team, or group. An organization is responsible for:

  • Member management - Adding, removing, and managing team members and their roles
  • Security - Controlling access, permissions, and security settings across all workspaces
  • Billing & subscriptions - Managing licenses and payments
  • Workspace governance - Managing all workspaces

All workspaces belong to and are managed by an organization.

Workspaces​

A workspace is a space in an organization where teams collaborate on architecture diagrams. Each workspace has its own:

  • Set of diagrams & integrations, and model - All your architecture documentation within that workspace
  • Team of members - Selected organization members with access to that workspace
  • Roles and permissions - Access control specific to the workspace

Structure Overview​

Organization
├── All workspaces' members
├── Billing
├── Security
│
├── Workspace Alpha
│ ├── Some members
│ ├── Diagrams
│ ├── Components
│ └── Integrations
│
└── Workspace Beta
├── Some (perhaps different) members
├── Diagrams
├── Components
└── Integrations

Team Members and Access​

Organization members can be granted access to specific workspaces. This allows you to:

  • Restrict access - Not all team members need access to all workspaces
  • Manage permissions - Set specific roles (Reader, Editor, Admin) for each member in each workspace