> ## Documentation Index
> Fetch the complete documentation index at: https://docs.diagram.eoeok.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Team workspaces and permissions

> Understand Business organizations, team workspaces, member roles, and editing locks.

A Business subscription creates an organization for shared seats, credits, billing, and team workspaces. A person must belong to the organization before they can be added to one of its workspaces.

## 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.

<Steps>
  <Step title="Open a team diagram">
    If no one else is editing, DiagramAI acquires the lock and enables editing.
  </Step>

  <Step title="Work while the lock is active">
    DiagramAI refreshes the lock while the editor remains active.
  </Step>

  <Step title="Handle a locked diagram">
    If another member holds the lock, the diagram opens read-only and the AI panel is disabled.
  </Step>

  <Step title="Take over when required">
    A workspace Owner or Admin can force a takeover. The previous editor can no longer save changes
    after the takeover.
  </Step>
</Steps>

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

## Shared credits

AI requests made inside a team workspace use the organization's shared balance. Organization usage and recent credit activity are available from **Usage & billing**.

See [Plans, credits, and billing](/en/plans-and-credits) for included credits and seat pricing.