Workspaces - amitsri/rostyman-releases GitHub Wiki

Workspaces

Workspaces let you organize your API projects separately. Each workspace has its own collections, environments, global variables, vault secrets, 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 showing all your workspaces.

Creating a Workspace

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

The new workspace opens with a clean state — no collections, no tabs.

Switching Workspaces

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

Searching Workspaces

Type in the search box at the top of the workspace switcher to filter workspaces by name.

Workspace Context Menu

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

Action Description
Rename Edit the workspace name inline; press Enter or click away to confirm
Settings Open the workspace tab (Overview, Request Settings, Proxy)
Export Workspace 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.

Default Workspace

"My Workspace" is the built-in default workspace. It:

  • Shows a DEFAULT badge in the switcher
  • Cannot be renamed or deleted
  • Is automatically selected when another workspace is deleted
  • Receives all existing data when upgrading from beta.12 or earlier

Workspace Settings Tab

Open the workspace tab by double-clicking the workspace name in the title bar, or via ⋯ → Settings.

The workspace tab has three sections:

Overview

  • Name — rename the workspace (not available for the default workspace)
  • Description — optional freeform text description
  • Color — change the workspace color from the 12-color palette
  • Stats — live counts of collections, requests, environments, variables, vault secrets, mock servers, workflows, and scheduled jobs
  • Export — save this workspace to a .rostyman-workspace file

Request Settings

Override global defaults (Settings > General) for all requests in this workspace:

Setting Options Default
HTTP Timeout Use global / 10s / 30s / 1m / 2m / 5m Use global
SSL Verification Use global / Enabled / Disabled Use global
Follow Redirects Use global / Enabled / Disabled Use global
Source Check Interval Use global / Startup only / 1m / 2m / 5m Use global

Priority chain: Per-request override > Workspace setting > Global setting

Proxy

Configure a workspace-specific proxy for all requests in this workspace:

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

When set, the workspace proxy takes precedence over any global proxy configured in Settings.

Importing a Workspace

Click the upload icon in the workspace switcher, then select a .rostyman-workspace file. A new workspace is created with all the imported data.

Exporting a Workspace

Via ⋯ → Export Workspace on any workspace in the switcher, or from the workspace tab Overview section.

The .rostyman-workspace format includes:

  • All collections, folders, and requests (with auth, headers, scripts, and variables)
  • All environments and environment variables
  • Global variables and vault secrets
  • Mock server definitions and their variables (not running state)
  • Workflow definitions (nodes, edges, viewport)
  • 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

The workspace moves to Trash (soft-delete) and can be restored or permanently deleted from there. If you delete the currently active workspace, Rostyman automatically switches to the default workspace.

Tab Persistence

Each workspace remembers its open tabs. When you switch workspaces:

  1. Current open tabs are saved
  2. All tabs close
  3. The target workspace's previously saved tabs are restored

Data Isolation

Switching workspaces fully reloads:

  • Collections, folders, and requests
  • Global variables and vault secrets
  • Workflows and scheduled jobs
  • Mock servers
  • AI conversation history
  • Request history status dots
  • Environment selections