Account

# Exporting your config

Download every bin, schema and kept version as one JSON file, from the dashboard or the API.

An administrator can download everything in an organization from **Settings → Export**. The same export is available over the API with a secret key that isn't limited to some bins or environments:

```
curl -H "Authorization: Bearer $HOTCFG_API_KEY" \
  "https://api.hotcfg.run/v1/organizations/<org-id>/export" > hotcfg-export.json
```

Add `?versions=current` for only the version each environment serves now. The organization id (`org_…`) is shown by `GET /v1/auth/me`.

With the CLI, [`hotcfg export`](https://hotcfg.run/docs/cli/export) does the same and checks the file is complete.

## What's in it

```
{
  "format": "hotcfg-export/1",
  "exported_at": "2026-11-10T12:00:00Z",
  "organization": { "id": "org_8f3a2c", "slug": "acme", "name": "Acme", "plan": "pro" },
  "bins": [
    {
      "id": "mobile-flags",
      "name": "Mobile flags",
      "description": null,
      "is_public": true,
      "schema": { "type": "object" },
      "created_at": "2026-11-03T09:00:00Z",
      "environments": {
        "production": [
          { "version": 1, "current": false, "hash": "…", "author_type": "user", "author_id": "usr_…", "created_at": "…", "payload": { "newCheckout": false } },
          { "version": 2, "current": true, "hash": "…", "author_type": "api_key", "author_id": "key_…", "created_at": "…", "payload": { "newCheckout": true } }
        ]
      }
    }
  ]
}
```

- Versions are oldest first. `current` marks the one the environment serves. An unpublished environment has versions but none is current.
- `payload` is exactly what you published, numbers included.
- The export holds what your plan keeps: older versions past the [kept count](https://hotcfg.run/docs/reference/limits) are already deleted.
- It's a consistent snapshot: publishes during the download aren't half-included.

Exports are always available, on every plan.

Last updated 10 November 2026
