# Workspace Management

> Create and manage workspaces to organize your agents, prompts, credentials, and team members.

Source: https://0.0.0.0:8080/docs/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:

1. Open the workspace switcher.
2. Select **Create Workspace**.
3. Enter the workspace name and slug.
4. 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:

```text
my-company-staging
```

## Workspace 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](/docs/billing-and-plans) for details.

## Related Topics

- [Team and Roles](/docs/team-and-roles) -- Managing workspace members
- [Billing and Plans](/docs/billing-and-plans) -- Workspace billing configuration
- [API Keys and Scopes](/docs/api-keys-and-scopes) -- Workspace-scoped API keys