Workspace Management

Workspaces isolate your API projects. Each workspace has its own collections, environments, globals, vault, mock servers, workflows, and scheduled jobs.

Opening the Workspace Switcher

Click the workspace name in the center of the title bar. A dropdown panel opens.

Creating a Workspace

1. Open the workspace switcher
2. Click Create
3. Type a name and press Enter (or click the checkmark)
4. Pick a color from the palette

The new workspace starts empty.

Switching Workspaces

Click any workspace in the list to switch. All tabs from the previous workspace are saved and restored when you switch back.

Searching Workspaces

Type in the search box in the workspace switcher to filter by name.

Workspace Context Menu

Click the ⋯ (three dots) on any workspace to:

Action	Description
Rename	Edit the workspace name inline
Settings	Open the workspace tab with Overview, Request Settings, and Proxy sections
Export	Save the workspace as a .rostyman-workspace file
Delete	Soft-delete the workspace (recoverable from Trash)

The default workspace ("My Workspace") cannot be renamed or deleted.

Workspace Settings Tab

Double-click the workspace name or choose ⋯ → Settings to open the workspace tab.

Overview

• Name — rename the workspace
• Description — optional text description
• Color — change the workspace color
• Stats — count of collections, requests, environments, variables, vault secrets, mock servers, workflows, and jobs
• Export — save to .rostyman-workspace format

Request Settings

Override global defaults for all requests in this workspace:

Setting	Default	Description
HTTP Timeout	30s	Request timeout (0 = no timeout)
SSL Verification	On	Verify SSL certificates
Follow Redirects	On	Auto-follow 3xx redirects
Source Check Interval	Startup only	When to check linked source files

Priority: Per-request override > Workspace > Global (Settings tab).

Proxy

Configure a workspace-specific HTTP/HTTPS/SOCKS5 proxy:

• Protocol — HTTP, HTTPS, or SOCKS5
• Host — proxy server hostname or IP
• Port — proxy port
• Auth — enable/disable proxy authentication
• Username / Password — credentials if auth enabled

Export & Import

Export: Click ⋯ → Export on any workspace. A .rostyman-workspace file is saved to disk.

Import: Click the upload icon in the workspace switcher. Select a .rostyman-workspace file. A new workspace is created with all the imported data.

The .rostyman-workspace format includes:

• All collections, folders, and requests (with auth, scripts, variables)
• All environments and environment variables
• Global variables and vault secrets
• Mock servers (definitions, not running state)
• Workflow definitions
• Scheduled job definitions
• Workspace settings (proxy, timeout overrides)

Deleting a Workspace

1. Open the workspace switcher
2. Click ⋯ → Delete on the workspace
3. Confirm the deletion
4. The workspace moves to Trash where it can be restored for 30 days

Deleting the currently active workspace automatically switches you to the default workspace.