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
- Go to Settings → Workspaces
- Click New Workspace
- Enter a name (up to 200 characters)
- 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
Deleting a workspace removes all pipelines, documents, and runs within it. This action cannot be undone.
API usage
When using the Ingestly API, include the X-Workspace-Id header to scope requests to a specific workspace. If omitted, the request targets the default workspace.
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 |
