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

# Workspace

> Team spaces where your workflows, jobs, and collaboration happen in Opus.

A workspace is where your team does its work in Opus. Think of it like a shared folder for your team—everything inside (workflows, jobs, reviews) belongs to that team, and you control who can access it.

## What Can You Do With A Workspace?

<CardGroup cols={2}>
  <Card title="Keep Things Organized" icon="folder">
    All your workflows, jobs, and reviews live in one place.
  </Card>

  <Card title="Work Together" icon="users">
    Invite teammates and decide who can build, run, or review.
  </Card>

  <Card title="Track What's Running" icon="chart-line">
    See job history, results, and status all in one place.
  </Card>

  <Card title="Manage Reviews" icon="clipboard-check">
    Route review tasks to the right people and track progress.
  </Card>
</CardGroup>

## What's Inside A Workspace?

Every workspace contains:

* **Workflows** — Your automation blueprints
* **Jobs** — Runs of those workflows
* **Reviews** — Items waiting for human approval
* **Members** — Your team
* **Settings** — Name, icon, and description

## Team Roles

Everyone in a workspace has a role that determines what they can do:

| Role         | What They Can Do                                                       |
| ------------ | ---------------------------------------------------------------------- |
| **Admin**    | Everything—build workflows, run jobs, manage the team, change settings |
| **Builder**  | Create and edit workflows, run jobs                                    |
| **Operator** | Run jobs and see results (can't edit workflows)                        |
| **Reviewer** | Only see and complete review tasks assigned to them                    |

### What Each Role Can Do

<AccordionGroup>
  <Accordion title="Admin">
    Admins have full control:

    * Create, edit, and delete workflows
    * Run jobs and see all results
    * Invite people and change their roles
    * Access all reviews
  </Accordion>

  <Accordion title="Builder">
    Builders create and run workflows:

    * Create and edit workflows
    * Run jobs and see results
    * Complete reviews
    * Can't invite people or change settings
  </Accordion>

  <Accordion title="Operator">
    Operators run workflows others have built:

    * See workflows (but not edit them)
    * Run jobs and see results
    * Complete reviews
    * Can't create workflows or manage the team
  </Accordion>

  <Accordion title="Reviewer">
    Reviewers handle approval tasks:

    * See workflows related to their reviews
    * Complete review tasks assigned to them
    * Can't run jobs or edit anything
  </Accordion>
</AccordionGroup>

## Adding People To Your Workspace

<Steps>
  <Step title="Go to workspace settings">
    Click **Workspace Settings → Members** from your workspace.
  </Step>

  <Step title="Invite people">
    Click **Invite Members** and enter their email addresses. You can invite multiple people at once.
  </Step>

  <Step title="Pick their role">
    Choose Admin, Builder, Operator, or Reviewer for each person.
  </Step>

  <Step title="Set up review access (for Reviewers)">
    If you're adding Reviewers, choose which review queues they can see.
  </Step>

  <Step title="Send the invites">
    Click send and track who's accepted in your members list.
  </Step>
</Steps>

<Tip>
  Inviting a whole team? Use bulk invitations—everyone gets the same role, and you can adjust individually later.
</Tip>

### Changing Someone's Access

Admins can:

* Change anyone's role
* Update which reviews someone can see
* Remove people from the workspace

Every change is logged so you can see who did what.

## Customizing Your Workspace

Make your workspace easy to find in **Workspace Settings → Profile**:

| Setting         | What It Does                                      |
| --------------- | ------------------------------------------------- |
| **Name**        | What your workspace is called                     |
| **Icon**        | A visual marker to spot it quickly                |
| **Description** | A short explanation of what this workspace is for |
| **Tags**        | Keywords to help people find it                   |

<Tip>
  Good names and descriptions help people find the right workspace fast—especially when your organization has lots of them.
</Tip>

## Ways To Organize Workspaces

### By Business Area

* **Finance Workspace**: Invoicing, expense reports, financial automation
* **Compliance Workspace**: KYC checks, regulatory workflows
* **Operations Workspace**: Internal processes, HR automation
* **QA Workspace**: Testing and quality checks

### By Team

* Each team gets their own workspace
* Team leads are Admins
* Team members are Builders or Operators
* Stakeholders are Reviewers

### By Stage

* **Development Workspace**: For testing and building
* **Production Workspace**: For live workflows with real data

<Warning>
  If you use sub-workflows (workflows that call other workflows), they all need to be in the same workspace. Keep this in mind when planning your setup.
</Warning>

## Tips For Running Your Workspace

<AccordionGroup>
  <Accordion title="Plan your workspace structure">
    * Organize by team or business area—whatever makes sense for you
    * Remember that sub-workflows need to live together
    * Balance keeping things separate vs. making collaboration easy
  </Accordion>

  <Accordion title="Match roles to what people actually do">
    * **Admins**: Team leads, people who own the workflows
    * **Builders**: Developers, automation specialists
    * **Operators**: Business users who just need to run things
    * **Reviewers**: Approvers, QA, compliance folks
  </Accordion>
</AccordionGroup>

### Day-To-Day Tips

1. **Name things clearly** — Future you will thank you
2. **Check job history** — See what's working and what's failing
3. **Review access regularly** — Remove people who don't need it anymore

## How Workspaces Fit Into Organizations

Workspaces live inside your organization and inherit some things automatically:

* **Policies**: Review settings and workflow rules
* **Features**: What's available based on your plan

This setup lets your company set the rules while giving teams freedom to work their way.

```
Organization (company-wide settings and billing)
    └── Workspace A (Team Alpha)
    └── Workspace B (Team Beta)
    └── Workspace C (Shared automations)
```

## Related Resources

<CardGroup cols={2}>
  <Card title="Organization" icon="building" href="/guides/organization">
    Company-wide settings that workspaces inherit.
  </Card>

  <Card title="Workflows" icon="diagram-project" href="/guides/workflows">
    Build automations for your workspace.
  </Card>

  <Card title="Jobs" icon="play" href="/guides/jobs">
    Run workflows and see results.
  </Card>

  <Card title="Builder" icon="hammer" href="/guides/builder">
    The visual editor for creating workflows.
  </Card>
</CardGroup>