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

# Workspaces

> Organize your pipelines and resources into separate workspaces.

Workspaces let you organize pipelines and their associated resources into separate groups within your organization. Each workspace acts as an isolated container: pipelines, documents, and runs in one workspace are not visible in another.

## Default workspace

Every organization starts with a **Default** workspace. If you don't create additional workspaces, all your pipelines live here. The default workspace cannot be deleted.

## Creating a workspace

1. Go to **Settings** → **Workspaces**
2. Click **New Workspace**
3. Enter a name (up to 200 characters)
4. Click **Create**

## Switching workspaces

Use the **workspace switcher** dropdown in the sidebar to switch between workspaces. The selected workspace determines which pipelines, documents, and runs you see throughout the app.

## Workspace scoping

Pipelines are scoped to the workspace they were created in. When you create a new pipeline, it belongs to the currently selected workspace. The pipelines list, runs, documents, and dashboard metrics all reflect the active workspace.

## Editing and deleting workspaces

From **Settings** → **Workspaces**, you can:

* **Edit:** rename a workspace
* **Delete:** permanently remove a workspace

<Warning>Deleting a workspace removes all pipelines, documents, and runs within it. This action cannot be undone.</Warning>

## API usage

When using the [Ingestly API](/api-reference/introduction), include the `X-Workspace-Id` header to scope requests to a specific workspace. If omitted, the request targets the default workspace.

```bash theme={null}
X-Workspace-Id: your-workspace-id
```

## Permissions

Managing workspaces requires a role with **Core.Workspace** permissions:

| Permission              | Description           |
| ----------------------- | --------------------- |
| `Core.Workspace.Read`   | View workspaces       |
| `Core.Workspace.Create` | Create new workspaces |
| `Core.Workspace.Update` | Rename workspaces     |
| `Core.Workspace.Delete` | Delete workspaces     |