Workspaces let you organize pipes and their associated resources into separate groups within your organization. Each workspace acts as an isolated container — pipes, files, 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 pipes live here. The default workspace cannot be deleted.
Creating a workspace
- Go to Settings → Workspaces
- Click Create 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 pipes, files, and runs you see throughout the app.
Workspace scoping
Pipes are scoped to the workspace they were created in. When you create a new pipe, it belongs to the currently selected workspace. The pipes list, runs, files, 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 pipes, files, and runs within it. This action cannot be undone.
API usage
When using the DocPipe 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 |
