Workspace Settings
Workspace settings let you configure how a specific workspace behaves. You can manage general details, control who has access, toggle enterprise features, add workspace-specific rules, and manage credentials.
General
The General tab covers the basics of your workspace.
- Name and slug to identify the workspace
- Description to explain what the workspace is for
- Visibility to set the workspace as private, internal, or public. This is disabled if the workspace is connected to GitHub, since GitHub controls visibility at that point.
- Target branch to choose which branch pull requests are created against when publishing. Only available when connected to GitHub.
- Workflow to assign a workflow to the workspace. You can select from workflows your enterprise has configured and pin to a specific version.
- Delete workspace in the danger zone for when you need to remove the workspace entirely
Members
The Members tab has two sections for managing access.
Individuals lets you add enterprise members to the workspace and assign roles.
- Owner has full control over workspace settings, files, and members
- Admin can manage settings, files, and members but cannot delete the workspace
- Editor can edit files and use the agent
- Viewer can view files and conversations but cannot make changes
Teams lets you add enterprise teams to the workspace. When team membership changes at the enterprise level, workspace access updates automatically.
Agents
The Agents tab shows all subagents available to the workspace, organized into custom agents created by your enterprise and built-in agents provided by the platform.
You can enable or disable agents for this workspace. Agents that are marked as required at the enterprise level are locked on and cannot be disabled. For custom agents, you can pin to a specific version and upgrade when a newer version is available.
Rulesets
The Rulesets tab shows three levels of rules that apply to the workspace.
Enterprise rulesets inherited from your organization. Required rulesets are always active. Optional rulesets can be toggled on or off for this workspace.
Workspace rulesets that you create specifically for this project. You can create rulesets from scratch or import them. Each ruleset contains individual rules that you can add, edit, and toggle.
Personal rulesets that you've configured in your account settings. These are shown for reference but managed from your account settings.
For the full picture on how rulesets work across all three levels, see Rulesets.
Secrets
The Secrets tab lets you add workspace-scoped credentials. Each secret has a key, a value, an optional description, and a sensitivity flag. Sensitive secrets cannot be read after saving.
If a workspace secret has the same key as an enterprise secret, the workspace secret takes precedence for this workspace. See Secrets for more on how secrets work.