Skip to main content

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

  1. Click the workspace name in the title bar
  2. Click Create
  3. Type a name and press Enter

New workspaces start empty with a unique color from the palette.

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:

SettingDescription
HTTP TimeoutRequest timeout for all requests
SSL VerificationEnable/disable SSL certificate checks
Follow RedirectsAuto-follow HTTP redirects
Source Check IntervalHow often to check linked source files

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

Proxy

Configure a workspace-specific proxy server (protocol, host, port, auth).

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-workspace file 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.