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

# OpenAPI Sync

> Keep Mintlify API reference in sync with production.

Mintlify generates the API reference from `openapi/signalite.json`.

## Refresh the spec

From the web repo:

```bash theme={null}
npm run docs:sync-openapi
```

This fetches:

```text theme={null}
https://shlp-web-production.up.railway.app/api/v1/openapi
```

and writes:

```text theme={null}
mintlify/openapi/signalite.json
```

## Validate locally

Install Mintlify's CLI and run from the docs root:

```bash theme={null}
npm i -g mint
cd mintlify
mint validate
mint broken-links
mint dev
```

## Mintlify setup notes

Mintlify uses `docs.json` as the required central config. The API reference tab points at `openapi/signalite.json`, which lets Mintlify generate interactive endpoint pages from the OpenAPI document.