Workspace Management
Create and manage workspaces to organize your agents, prompts, credentials, and team members.
Workspace Management
Workspaces are the top-level organizational unit in PromptRails. Every resource -- agents, prompts, credentials, executions, traces, and team members -- belongs to a workspace. Users can create multiple workspaces and switch between them.
Creating Workspaces
Create a workspace through the PromptRails dashboard:
- Open the workspace switcher.
- Select Create Workspace.
- Enter the workspace name and slug.
- Confirm creation.
When a user creates a workspace, they automatically become the owner of that workspace.
Workspace Slug
Each workspace has a unique slug:
- Must be lowercase alphanumeric with hyphens
- Must be unique across the platform
Example slug:
my-company-stagingWorkspace Settings
Update workspace settings from the dashboard's workspace settings screen, including the display name and slug.
Workspace Scope
All resources in PromptRails are workspace-scoped:
| Resource | Workspace-Scoped |
|---|---|
| Agents | Yes |
| Prompts | Yes |
| Credentials | Yes |
| Data Sources | Yes |
| MCP Tools | Yes |
| Executions | Yes |
| Traces | Yes |
| Chat Sessions | Yes |
| Memories | Yes |
| Scores | Yes |
| Guardrails | Yes (via agent) |
| API Keys | Yes |
| Webhook Triggers | Yes |
| Approvals | Yes |
| Agent UI Deployments | Yes |
This means resources in one workspace are completely isolated from another workspace. A credential in workspace A cannot be used by an agent in workspace B.
Plans and Limits
Each workspace is associated with a billing plan that defines resource limits:
- Maximum number of monthly executions
- Maximum number of active agents
- Maximum number of team members
- Maximum number of data sources
- Feature flags (memory, approvals, MCP, etc.)
See Billing and Plans for details.
Related Topics
- Team and Roles -- Managing workspace members
- Billing and Plans -- Workspace billing configuration
- API Keys and Scopes -- Workspace-scoped API keys