Workspaces
Organize your API collections, folders, and requests in personal and team workspaces.
Workspaces help you organize your API projects. You can create personal workspaces for individual work or organization workspaces for team collaboration.
Each workspace also runs in a mode — local, git, or cloud — which decides where its data lives and whether an account is involved. A local workspace needs no account and no network; git and cloud workspaces require a RESTK account. See Workspace Modes before you create your first workspace.
Quick Start
Create a Workspace
Click + Add Workspace to create a new workspace
Name Your Workspace
Enter a unique name like "Development APIs" or "Production Testing"
Start Building
Add collections, folders, and requests to your workspace
Offline Support
Local workspaces are created, edited, and deleted entirely offline — no account, no connection. For cloud and organization workspaces you can always view and browse offline, but creating, editing, and deleting them requires an internet connection.
Creating a Workspace
Personal Workspaces
Navigate to Workspaces
View your workspace list in the sidebar
Add Workspace
Click the + button or Add Workspace
Enter Details
Provide a workspace name and click Create
Internet Required for Cloud Workspaces
Creating a cloud or organization workspace requires an internet connection and a signed-in account. Creating a local workspace does not.
Organization Workspaces
Organization workspaces allow your team to collaborate on API projects.
Switch to Organization
Select your organization from the context switcher
Create Workspace
Click + Add Workspace (Owner or Admin org role required)
Configure
Enter the workspace name and save
Who can create organization workspaces:
- Owner and Admin can create, edit, and delete workspaces
- Members can view and work within workspaces they have access to
Two Role Systems
Organization roles (Owner/Admin/Member) control who can create and manage workspaces. Workspace roles (Owner/Manager/Editor/Viewer) control what you can do inside a workspace. See Roles & Permissions for details.
Editing a Workspace
Open Workspace Menu
Right-click on a workspace in the list
Select Edit
Choose Edit from the context menu
Update Name
Change the workspace name and save
Internet Required for Cloud Workspaces
Editing a cloud or organization workspace requires an internet connection. Local workspaces can be renamed and edited offline.
Deleting a Workspace
Right-Click Workspace
Open the context menu for the workspace
Select Delete
Choose Delete from the menu
Confirm Deletion
Confirm to permanently delete the workspace and all its contents
Permanent Action
Deleting a workspace removes all collections, folders, and requests inside it. This action cannot be undone.
Switching Between Workspaces
Click any workspace in the sidebar to switch to it. Your currently selected workspace displays its collections, folders, and requests in the main view.
Features:
- Switch instantly between workspaces
- Each workspace maintains its own content
- Your last selected workspace is remembered when you restart
Switching Contexts
Personal to Organization
Open Context Switcher
Click the context switcher at the top of the sidebar
Select Organization
Choose your organization from the list
View Workspaces
Organization workspaces load with appropriate permissions
Organization to Personal
Open Context Switcher
Click the context switcher
Select Personal
Choose Personal to return to your individual workspaces
Context Memory
The app remembers your last context and workspace selection when you restart.
Offline Behavior
When offline, you can:
- View and browse all cached workspaces
- Switch between workspaces
- Work with cached collections and requests
When offline, you cannot:
- Create, edit, or delete cloud or organization workspaces (these require internet)
Local workspaces are unaffected — you can create, rename, and delete them offline like any other local data.
Auto-Sync
When you reconnect, the app automatically refreshes your workspace data.
Workspace State
Empty Workspace
If you have no workspaces, you'll see an empty state with a prompt to create your first workspace.
Create First Workspace
Click Create Your First Workspace (a cloud or organization workspace requires internet; a local one does not)
Name It
Choose a name for your initial workspace
Start Building
Begin adding collections and requests
Active Workspace Deleted
If the workspace you're viewing gets deleted (by you or another team member), the app automatically switches to another available workspace or shows the empty state.
Permissions
Personal Workspaces
| Action | Available | Requires Internet |
|---|---|---|
| Create | Yes | Only for cloud workspaces |
| Edit | Yes | Only for cloud workspaces |
| Delete | Yes | Only for cloud workspaces |
| View | Yes | No |
Organization Workspace Management
Organization roles control who can create, edit, and delete workspaces:
| Org Role | Create Workspace | Edit Workspace | Delete Workspace | View Workspaces |
|---|---|---|---|---|
| Owner | Yes | Yes | Yes | Yes |
| Admin | Yes | Yes | Yes | Yes |
| Member | No | No | No | Yes |
Because organization workspaces are cloud-backed, all create, edit, and delete operations on them require an internet connection.
Workspace Content Permissions
Once inside a workspace, workspace roles control what you can do with collections, folders, and requests:
| Workspace Role | View | Create & Edit | Delete | Manage Members |
|---|---|---|---|---|
| Owner | Yes | Yes | Yes | Yes |
| Manager | Yes | Yes | Yes | Yes |
| Editor | Yes | Yes | No | No |
| Viewer | Yes | No | No | No |
Workspace Roles vs Organization Roles
Organization roles (Owner/Admin/Member) control workspace management. Workspace roles (Owner/Manager/Editor/Viewer) control content permissions within a workspace. See Roles & Permissions for the full breakdown.
Best Practices
- Use Descriptive Names - Name workspaces clearly like "Mobile App APIs" or "E-commerce Backend"
- Organize by Project - Create separate workspaces for different projects or environments
- Team Workspaces for Collaboration - Use organization workspaces when working with your team
- Personal for Experiments - Use personal workspaces for testing and experimentation