> ## Documentation Index
> Fetch the complete documentation index at: https://docs.arcuserp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Insomnia Collection

> Download the official Arcus ERP Insomnia collection for all API endpoints.

## Download

<Card title="Download Insomnia Collection" icon="download" href="/insomnia-collection.json">
  Click to download `arcus-erp-v1-insomnia.json`
</Card>

Alternatively, download from **Settings > Developers > Collections** in the Arcus app.

## Import into Insomnia

1. Open Insomnia and go to **File > Import**
2. Choose **Import From > File**
3. Select `arcus-erp-v1-insomnia.json`
4. Insomnia imports all endpoints organized into a collection

## Set up environment variables

In Insomnia, go to **Manage Environments** and create a new environment:

```json theme={null}
{
  "ARCUS_BASE_URL": "https://api.arcuserp.com/v1",
  "ARCUS_API_KEY": "ark_live_ent_...",
  "ARCUS_ENTITY_ID": "your-entity-uuid"
}
```

The collection references `{{ _.ARCUS_BASE_URL }}`, `{{ _.ARCUS_API_KEY }}`, and `{{ _.ARCUS_ENTITY_ID }}`. Use `ark_test_*` keys for sandbox data and `ark_live_*` keys for production data.

## OpenAPI import (alternative)

Insomnia can also import the OpenAPI spec directly:

1. **File > Import > From URL**
2. Enter `https://api.arcuserp.com/openapi.yaml`
3. Insomnia generates a collection from the spec

Note: the pre-built collection above includes example request bodies and environment templates not present in the raw spec import.