# 🚀 Getting Started with Requestly Local Workspace
*A complete guide to setting up and using Local Workspace for secure, offline API development.*

Local Workspace is a powerful feature in the Requestly Desktop App that allows developers to store and manage all API data **locally**, offering complete privacy, full control, and an offline-first workflow.

This guide will help you understand, configure, and use Local Workspace effectively.

---

## 📌 What Is Local Workspace?

Local Workspace is a workspace mode where **all your data is stored locally on your machine**, including:

- ✅ API Requests
- ✅ Collections
- ✅ Environment Variables
- ✅ Response history

Nothing syncs to cloud.
Nothing leaves your device.
Perfect for secure development environments. 🔒

> ⚠️ **Note* Local Workspace is currently in **early beta** and available only in the **Requestly Desktop App** (API Client).

---

## ⭐ Key Features

### 🔐 Local-Only Storage
All data stays in the directory you select — completely private.

### 📁 Local Collections
Organize and manage API collections from your filesystem.

### 🌐 Offline-First
Works fully without an internet connection.

### 🔧 API Client Support
Supports all major HTTP methods:
- GET
- POST
- PUT
- DELETE
- PATCH

### 🔄 Environment Variables
Use environment-specific variables like:

```txt
{{base_url}}
{{api_key}}
````

All stored locally.

---

## ⚙️ How to Create a Local Workspace

### **1️⃣ Open Workspace Menu**

Click the workspace name at the **top-left corner** of the Requestly Desktop App.

![Workspace Menu](https://via.placeholder.com/12....00x350.png?text=Work

---

### **2️⃣ Select “Join or Create Workspace”**

![Create Workspace](https://via.placeholder.com/12....00x350.png?text=Join

---

### **3️⃣ Choose “Local Workspace”**

Enter:

* Workspace Name
* Folder path for local storage

Recommended folder structure:

```
~/Requestly_Local_Workspace/
```

![Local Workspace Selection](https://via.placeholder.com/12....00x350.png?text=Sele

---

### **4️⃣ Click “Create” ✅**

Your new Local Workspace is ready to use.
All API data will now be stored locally.

![Workspace Created](https://via.placeholder.com/12....00x350.png?text=Work

---

## 🧪 What You Can Do Inside Local Workspace

### 🔍 Create & Test API Requests

Send:

* GET
* POST
* PUT
* DELETE

View JSON, raw responses, headers, and timing.

---

### 📂 Organize Collections Locally

Collections are saved as folders/files inside your chosen directory.

---

### 🔧 Use Local Environments

Keep private keys, URLs, and tokens offline.

---

### 📴 Work Completely Offline

No internet required for:

* Running requests
* Managing collections
* Editing environments

---

## 🚧 Current Limitations (Beta)

| Limitation | Status |
| ------------------------- | ------ |
| Only API Client supported | ✅ |
| No workspace delete UI | ✅ |
| Desktop App only | ✅ |
| Some features may change | ✅ |

For issues, feedback, or early access:
📬 **[contact@requestly.io](mailto:contact@requestly.io)**

---

## 📷 Replaceable Placeholder Screenshot Links

You can replace the following when adding real screenshots:

| Purpose | Link |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| Workspace Menu | [https://via.placeholder.com/1200x350.png?text=Workspace+Menu](https://via.placeholder.com/12....00x350.png?text=Work |
| Create Workspace | [https://via.placeholder.com/1200x350.png?text=Join+or+Create+Workspace](https://via.placeholder.com/12....00x350.png?text=Join |
| Select Workspace | [https://via.placeholder.com/1200x350.png?text=Select+Local+Workspace](https://via.placeholder.com/12....00x350.png?text=Sele |
| Workspace Created | [https://via.placeholder.com/1200x350.png?text=Workspace+Created](https://via.placeholder.com/12....00x350.png?text=Work |

---

## ✅ Summary

Local Workspace is the ideal solution for:

* 🔒 Privacy-first development
* 🛰️ Offline API testing
* 🧪 Local backend workflows
* 🗂️ Organizing secure API environments

It brings speed, confidentiality, and control to your development process.

For more updates, contributions, and documentation, visit:
👉 [https://github.com/requestly/r....equestly](https://gi


```