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

# Workspaces

> Manage your workflows and collaborate using workspaces.

Every Kadoa user gets a workspace automatically when they sign up. There are two types of workspaces:

* **Personal Workspace** - For individual users
* **Team Workspace** - For organizations and teams

## Personal Workspaces

This is your individual space to build and manage workflows.

### What You Can Do

* **Create Workflows** - Build data extraction workflows
* **Manage Data** - View, export, and deliver extracted data
* **Tag Workflows** - Categorize workflows using custom tags
* **Generate API Keys** - Access your data programmatically
* **Set Up Notifications** - Get alerts when workflows complete or encounter issues

***

## Team Workspaces

Team Workspaces enable organizations to collaborate on data extraction workflows with shared resources and centralized management.

### Key Benefits

* **Shared Resources** - Centralized usage tracking, workflows, and API keys across your organization
* **Flexible Permissions** - Role-based access control with Member, Admin, Viewer, and Compliance Officer roles
* **User Management** - Invite and manage team members from a single dashboard
* **Enterprise Security** - Compliance features, audit logging, and access controls
* **Organized Workflows** - Use tags and variables to categorize your team's workflows

### Getting Started

When you upgrade to an Enterprise plan, Kadoa automatically creates your team workspace:

* You become the initial team owner
* You can immediately invite team members
* Your usage limits are shared across all team members

### What's Included

Your team workspace includes:

* **Shared Workflows** - All team members can view and collaborate on workflows
* **Team Settings** - Manage members, permissions, and team configuration
* **Workspace API Key** - Generate a dedicated API key from **Settings > General**

### Manage Team Members

For step-by-step instructions on adding members, managing invitations, and changing roles, see [Team Management](/docs/ui/team-management).

### Roles and Permissions

Each role has specific permissions designed to balance collaboration with security.

#### Member

**Best for:** Team members who create and manage their own workflows

**Permissions:**

* Create new workflows for the team
* Read and execute all team workflows
* Edit their own workflows
* Download data from team workflows
* Use team tags and variables

**Limitations:**

* Cannot manage team settings or members
* Cannot access compliance or audit features

#### Admin & Owner

**Best for:** Team leads, project managers, and administrators

**Permissions (includes all Member permissions):**

* Manage team members (add, remove, change roles)
* Delete or modify any team workflow
* Access team settings and configuration
* Manage team tags and variables
* View usage and billing information

**Limitations:**

* Limited compliance access (depends on organization setup)

#### Viewer

**Best for:** Team members who need to consume data and monitor workflows without making changes

**Permissions:**

* Read-only access to all team workflows and extracted data
* View workflow execution results and logs
* Access tags and variables (read-only)
* View team activity and audit logs

**Cannot:** Create, edit, delete, or run workflows. Cannot manage team settings, members, or notifications.

**Use cases:**

* Data analysts who consume extracted data
* Stakeholders monitoring workflow performance
* MCP users who only need to query and view data

#### Compliance Officer

**Best for:** Compliance teams and auditors who need read-only access with compliance review powers

**Permissions:**

* Read-only access to all workflows and execution logs
* Access compliance reports and audit trails
* View team activity
* Approve or reject workflows pending compliance review (exclusive)

**Cannot:** Modify workflows, settings, or team configuration

**Use cases:**

* Regulatory compliance monitoring
* Security audits

### Advanced Features

Your team settings page provides additional collaboration features:

**Tags** help organize and categorize workflows:

* Create custom tags for projects, departments, or campaigns
* Filter and search workflows by tags
* Use tags for reporting and analytics

**[Variables](/docs/workflows/prompts#variables)** enable template-based workflows:

* Define reusable input variables for workflows
* Share variables across team workflows

**[Workspace API Keys](/api-reference/introduction)** enable programmatic access:

* Generate your API key from **Settings > General** (Admins and Owners only)
* API keys start with `tk-` and are tied to your workspace
* Actions via API key are attributed to your workspace's service account, not individual members
* Your integrations keep working even when team members leave or change roles

<Note>
  View the service account in your team members list. [Audit logs](https://www.kadoa.com/activity-log) show which actions were automated vs. manual.
</Note>

***

## Switch Between Workspaces

If you're a member of multiple workspaces (e.g., a Personal Workspace and one or more Team Workspaces), use the workspace switcher in the top navigation:

* Your active workspace determines which workflows and settings you can access
* Personal Workspace workflows remain private to you
* Usage is tracked separately for each workspace