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

# Workspaces in Chevre: Setup and Management Guide

> A workspace is the top-level container for your team's work in Chevre. Learn how to create, configure, and manage workspaces for your organization.

A workspace is the top-level container for your team's work in Chevre. All projects, workflows, members, and integrations belong to a workspace, and each workspace maintains its own isolated settings and billing. Think of a workspace as a dedicated environment — one for your engineering team, one for your operations team, or one for each client you serve.

## What a Workspace Contains

Every workspace gives your team a self-contained environment with the following resources:

| Resource         | Description                                                                                          |
| ---------------- | ---------------------------------------------------------------------------------------------------- |
| **Projects**     | Organized collections of workflows and automations scoped to a specific team or use case.            |
| **Members**      | The people who have access to the workspace and the roles that govern what they can do.              |
| **Billing**      | Subscription plan, usage metrics, and payment information specific to this workspace.                |
| **Settings**     | Name, slug, avatar, timezone, and other workspace-level configuration.                               |
| **Integrations** | Third-party connections (Slack, GitHub, webhooks, etc.) shared across all projects in the workspace. |

## Creating a Workspace

<Steps>
  <Step title="Open Workspace Settings">
    Click your current workspace name in the **top-left dropdown** of the dashboard to open the workspace switcher.
  </Step>

  <Step title="Select New Workspace">
    At the bottom of the workspace switcher, click **+ New Workspace**. The workspace creation dialog appears.
  </Step>

  <Step title="Name your workspace">
    Enter a display name for your workspace. Chevre will automatically generate a URL-safe slug from the name — you can customize this before saving.
  </Step>

  <Step title="Choose a plan">
    Select the subscription plan that fits your team's needs. You can upgrade or downgrade at any time from **Settings → Billing**.
  </Step>

  <Step title="Invite your team">
    Add team members by email address. You can skip this step and invite members later from **Settings → Members**.
  </Step>

  <Step title="Create the workspace">
    Click **Create Workspace**. Chevre provisions your new workspace and redirects you to its dashboard.
  </Step>
</Steps>

## Switching Between Workspaces

If you belong to more than one workspace, you can switch between them without logging out. Click the **workspace name in the top-left corner** of the dashboard to open the workspace switcher, then select the workspace you want to navigate to. The dashboard reloads with that workspace's projects and settings.

<Note>
  Your personal notification preferences and API tokens are tied to your user account, not a specific workspace. Workspace-level API keys are managed separately under **Settings → API Keys** within each workspace.
</Note>

## Workspace Settings

Customize your workspace at any time by navigating to **Settings → General**. The following fields are available:

| Setting      | Description                                                                                                        |
| ------------ | ------------------------------------------------------------------------------------------------------------------ |
| **Name**     | The display name shown in the dashboard and email notifications.                                                   |
| **Slug**     | The URL-safe identifier used in API endpoints and shareable links (e.g., `my-team`). Must be unique across Chevre. |
| **Avatar**   | A logo or icon that appears in the workspace switcher and notification emails.                                     |
| **Timezone** | The default timezone used for scheduled automations and run history timestamps.                                    |

<Note>
  Your workspace ID is used in API requests targeting resources within that workspace. For example: `GET https://api.chevre.io/v1/workspaces/{id}/projects`. You can find your workspace ID in **Settings → General**. If you change your workspace slug, update any dashboard bookmarks or shareable links that reference the old slug.
</Note>

## Workspace Limits by Plan

The number of workspaces your organization can create depends on your subscription plan.

| Plan           | Workspaces | Projects per workspace | Members per workspace |
| -------------- | ---------- | ---------------------- | --------------------- |
| **Free**       | 1          | Up to 3                | Up to 5               |
| **Pro**        | 3          | Unlimited              | Up to 25              |
| **Enterprise** | Unlimited  | Unlimited              | Unlimited             |

Upgrade your plan at any time from **Settings → Billing**. Limits apply at the organization level — contact [support@chevre.io](mailto:support@chevre.io) if you need a temporary increase.

## Deleting a Workspace

<Warning>
  Deleting a workspace is **permanent and irreversible**. All projects, workflows, automations, run history, members, and integrations inside the workspace are immediately and permanently destroyed. There is no recovery option. Export any data you need before proceeding.
</Warning>

To delete a workspace:

<Steps>
  <Step title="Open General Settings">
    Navigate to **Settings → General** inside the workspace you want to delete.
  </Step>

  <Step title="Scroll to the Danger Zone">
    Scroll to the bottom of the page to find the **Danger Zone** section.
  </Step>

  <Step title="Click Delete Workspace">
    Click **Delete Workspace** and follow the confirmation prompt. You must type the workspace slug exactly to confirm deletion.
  </Step>
</Steps>

Only workspace **Owners** can delete a workspace. If you are not the Owner, ask the Owner to perform this action or transfer ownership to you first in **Settings → Members**.