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