Workspaces let you organize workflows and their associated resources into separate groups within your organization. Each workspace acts as an isolated container: workflows, 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 workflows 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 workflows, documents, and runs you see throughout the app.
Workspace scoping
Workflows are scoped to the workspace they were created in. When you create a new workflow, it belongs to the currently selected workspace. The workflows 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 workflows, 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.
Permissions
Managing workspaces requires a role with Core.Workspace permissions:
