> For the complete documentation index, see [llms.txt](https://docs.jetpero.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.jetpero.com/help/troubleshooting-and-faq.md).

# Troubleshooting & FAQ

### 🔍 Common Issues & Fixes

#### 1. **❌ Receiving `401 Unauthorized` errors**

**Cause**: Invalid or missing API key.

**Fix**:

* Ensure the API key is included in the request header:

  ```http
  Authorization: Bearer YOUR_API_KEY
  ```
* Double-check you’re using the correct key for the right environment (e.g., production vs staging).
* Rotate your key if compromised or expired.

***

#### 2. **🚫 Getting `429 Too Many Requests` errors**

**Cause**: Rate limit exceeded.

**Fix**:

* Wait and retry after the time specified in the `Retry-After` response header.
* Implement exponential backoff.
* Consider upgrading your plan for higher rate limits.

***

#### 3. **🔒 CORS Issues in Browser**

**Cause**: Cross-Origin Resource Sharing (CORS) not enabled.

**Fix**:

* Ensure your front-end is allowed in CORS settings via your JetPero project dashboard.
* Use a proxy server if needed for local development.

***

#### 4. **📊 Analytics Not Updating in Dashboard**

**Cause**: Delay in data sync or API filters.

**Fix**:

* Check your time range filters.
* Wait a few minutes; analytics may have a slight delay (max 1–2 minutes).
* If it persists, contact support.

***

#### 5. **🧪 Test Environment Data Not Appearing**

**Cause**: You might be viewing the wrong environment.

**Fix**:

* Verify that you’ve selected the correct environment from your dashboard.
* Ensure API calls are using the correct environment key.

***

### ❓ Frequently Asked Questions

#### Q1: **Can I rotate API keys without downtime?**

**Yes.** You can create a new key, update your app to use the new one, then safely delete the old key.

***

#### Q2: **What happens if I hit my quota on a free plan?**

Your requests will return `429` errors until the next monthly cycle or until you upgrade to a paid plan.

***

#### Q3: **Can I separate environments (dev, staging, prod)?**

Absolutely. Each project can have multiple environments with isolated keys, analytics, and limits.

***

#### Q4: **How secure are my API keys?**

API keys are encrypted and never exposed in plaintext. Always keep them private, and rotate them regularly.

***

#### Q5: **Does JetPero support OpenAPI or Postman imports?**

**Coming Soon.** We're actively working on supporting OpenAPI 3.x imports and Postman collections. Stay tuned!

***

#### Q6: **How can I cancel my subscription?**

Go to **Dashboard → Settings** and click "Cancel Subscription." You’ll retain access until the end of your billing period.

***

### 🔧 Still need help?

Reach out to us:

* 📩 Email: <jetpero.io@gmail.com>
* 💬 Live Chat: via WhatsApp - +94706172020
* 🧠 Check our [Documentation ](/getting-started/quickstart.md)for deeper technical guides.