Workspaces

Workspaces let you isolate different projects. Each workspace has its own collections, environments, and OAuth configurations stored in a separate directory.

How It Works

A workspace is a directory on disk. When you switch workspaces, the backend reads and writes to that workspace's directory, so collections and environments from one project never bleed into another.

Requesto starts with a Default workspace. You can create as many additional workspaces as you need.

data/
├── workspaces.json           # Registry of all workspaces
├── Default/                  # Default workspace
│   └── .requesto/            # All workspace data
│       ├── collections.json
│       ├── environments.json
│       ├── oauth-configs.json
│       ├── .gitignore        # Ignores the local/ subdirectory
│       └── local/            # Local-only data (excluded from git)
│           ├── history.json
│           └── oauth-secrets.json
└── workspaces/               # Additional workspaces
    └── my-project/
        └── .requesto/
            ├── collections.json
            ├── environments.json
            ├── oauth-configs.json
            ├── .gitignore
            └── local/

Switching Workspaces

The workspace switcher is at the top of the sidebar. Click it to open a dropdown listing all your workspaces. Select one to switch to it.

If a workspace is a git repository, a branch icon appears next to its name.

The search box in the dropdown filters workspaces by name.

Managing Workspaces

Click Manage Workspaces... at the bottom of the workspace switcher dropdown to open the workspace manager.

From here you can:

• Create a new empty workspace
• Clone from Git to create a workspace from a git repository
• Open an existing directory as a workspace (desktop app only)
• Rename a workspace by clicking the pencil icon, which opens a rename dialog
• Delete a workspace (with confirmation). You cannot delete the last remaining workspace.
• Export a workspace as a JSON bundle containing all its collections, environments, and OAuth configs
• Import a workspace from a previously exported JSON file

Creating a Workspace

Click New Workspace in the workspace manager. Enter a name and click Create Workspace.

Cloning from Git

Toggle Clone from Git repository to create a workspace by cloning a git repo. Enter the repository URL and, for private repositories, a personal access token.

The repository is cloned into the workspaces/ directory and registered as a new workspace. Git operations (commit, push, pull, branch management) are available immediately. See Git Integration for details.

Opening an Existing Directory

In the desktop app, toggle Open existing directory and click Browse… to pick a folder on disk. This is useful when you already have a directory containing Requesto data files or a git repository cloned outside the default data directory. Click Add Workspace to register it.

Renaming a Workspace

Click the pencil icon next to a workspace in either the workspace switcher or the workspace manager. A dialog will appear where you can enter the new name and confirm.

Import & Export

Export: Click the export button on a workspace row in the manager. The exported JSON file includes all collections, environments, and OAuth configs from that workspace.

Import: Click Import in the workspace manager footer and select a JSON file. A new workspace is created with the imported data.

Data Isolation

Each workspace stores its data inside a .requesto/ subdirectory:

File	Location	Shared via git
collections.json	.requesto/	Yes
environments.json	.requesto/	Yes
oauth-configs.json	.requesto/ (no secrets)	Yes
history.json	.requesto/local/	No
oauth-secrets.json	.requesto/local/	No

The .requesto/local/ directory holds data that should stay local to your machine. When git is initialized in a workspace, a .requesto/.gitignore is automatically created to exclude the local/ subdirectory from version control. This means Requesto can safely coexist with an existing git project — only the .requesto/ folder is added to your repository.