> ## 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.

# Bruno Collection

> Download the official Arcus ERP Bruno collection. Bruno is a fast, git-friendly alternative to Postman.

## Download

[Bruno](https://www.usebruno.com) is a modern, offline-first API client that stores collections as plain files in your git repository. The Arcus ERP Bruno collection is auto-generated from the OpenAPI spec.

<Card title="Download Bruno Collection" icon="download" href="/bruno-collection.zip">
  Click to download `arcus-erp-v1-bruno.zip`
</Card>

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

## Import into Bruno

1. Unzip the downloaded archive
2. Open Bruno and click **Open Collection**
3. Navigate to the unzipped `arcus-erp-v1/` folder and open it
4. The collection loads with all endpoints organized by resource

## Set up your environment

Bruno environments are stored as `environments/*.bru` files in the collection folder. Edit `environments/production.bru`:

```bru theme={null}
vars {
  ARCUS_BASE_URL: https://api.arcuserp.com/v1
  ARCUS_ENTITY_ID: your-entity-uuid
}

vars:secret [
  ARCUS_API_KEY
]
```

Set `ARCUS_API_KEY` via Bruno's secrets panel (never committed to git). Use `ark_test_*` keys for sandbox data and `ark_live_*` keys for production data.

## Git-friendly workflow

Because Bruno stores collections as plain files, you can commit your Arcus API calls alongside your application code:

```bash theme={null}
your-project/
  src/
  arcus-api/          # Bruno collection committed here
    accounts/
      list-accounts.bru
      create-account.bru
    orders/
      ...
```

Changes to the collection are visible in `git diff`, making API contract changes reviewable in pull requests.