Team workspaces and permissions

Organizations and workspaces

The organization controls the subscription, seats, shared credits, organization members, and team workspaces.

A team workspace controls access to a specific set of folders and diagrams.

Organization Owners and Admins can create team workspaces.

Organization members only see team workspaces to which they have access.

An active Business entitlement is required to create, edit, or use AI in team workspaces.

Workspace roles

Action	Owner	Admin	Member
View the workspace	Yes	Yes	Yes
Create and edit diagrams	Yes	Yes	Yes
Move diagrams to trash	Yes	Yes	Yes
Use AI with shared credits	Yes	Yes	Yes
Manage workspace members	Yes	Yes	No
Change workspace settings	Yes	Yes	No
Permanently delete diagrams	Yes	Yes	No
Assign or manage the Owner role	Yes	No	No

The last workspace Owner cannot be demoted or removed.

Organization roles

Owner can manage organization members, roles, workspaces, seats, and billing.

Admin can manage members and workspaces but cannot assign, demote, or remove an Owner.

Member can use the team workspaces assigned to them.

Existing DiagramAI users join an organization immediately when invited. New users join after signing in with the invited email address.

Editing locks

Team diagrams use an editing lock to prevent conflicting saves.

Open a team diagram

If no one else is editing, DiagramAI acquires the lock and enables editing.

Work while the lock is active

DiagramAI refreshes the lock while the editor remains active.

Handle a locked diagram

If another member holds the lock, the diagram opens read-only and the AI panel is disabled.

Take over when required

A workspace Owner or Admin can force a takeover. The previous editor can no longer save changes after the takeover.

Confirm with the current editor before forcing a takeover. Unsaved changes in the previous browser session may not reach the workspace.

Organizations and workspaces