Workspaces
Workspaces let you organize your API projects into isolated environments. Each workspace has its own collections, environments, global variables, vault secrets, mock servers, workflows, and scheduled jobs.
Workspace Switcher
The workspace switcher is in the center of the title bar. Click it to:
- Search and switch between workspaces
- Create a new workspace
- Import a workspace from a file
Creating a Workspace
- Click the workspace name in the title bar
- Click Create
- Type a name and press Enter
New workspaces start empty with a unique color from the palette. You can change the color in workspace settings — the color appears as a small dot next to the workspace name in the switcher and in the title bar.
Workspace Settings
Double-click the workspace name (or use ... > Settings) to open the workspace tab:
Overview
- Name, description, color
- Stats dashboard (collections, requests, environments, globals, vault, mock servers, workflows, jobs)
- Export workspace
Request Settings
Override global defaults for this workspace:
| Setting | Description |
|---|---|
| HTTP Timeout | Request timeout for all requests |
| SSL Verification | Enable/disable SSL certificate checks |
| Follow Redirects | Auto-follow HTTP redirects |
| Source Check Interval | How often to check linked source files |
Priority: Per-request > Workspace > Global (Settings tab)
Proxy
Configure a workspace-specific proxy server (protocol, host, port, auth).
Context Menu
Right-click any workspace in the switcher dropdown to access:
| Action | Description |
|---|---|
| Open Settings | Open the workspace settings tab |
| Rename | Rename inline |
| Duplicate | Create a copy with all collections and data |
| Export | Save as .rostyman-workspace file |
| Delete | Move to Trash (recoverable) |
Default Workspace
"My Workspace" is the default workspace and cannot be renamed or deleted. When upgrading from an older version, all existing data is automatically placed in this workspace.
Export & Import
- Export:
...menu > Export Workspace (saves.rostyman-workspacefile with everything) - Import: Upload icon in the workspace switcher (creates a new workspace)
Deleting
Deleted workspaces go to Trash where they can be restored. Deleting the active workspace auto-switches to the default.