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

# CLAUDE

# Mintlify Directory

This directory contains the documentation frontend powered by [Mintlify](https://mintlify.com/). It renders the OpenAPI specification from `Spec/` into a user-facing API reference website.

## Layout

* **`docs.json`** — Mintlify site configuration (navigation, theme, metadata)
* **`api-reference/`** — Bundled OpenAPI spec consumed by Mintlify (`bundled.yaml`)
* **`*.mdx`** (at this directory's root) — Custom documentation pages. Each file maps 1:1 to a URL (`getting-started.mdx` → `/getting-started`).
* **`icons/`** — Custom icon assets
* **`scripts/`** — Post-bundle transforms (see below)
* **`Dockerfile`** — Container setup for the documentation site

## Key Files

* `api-reference/bundled.yaml` — The bundled OpenAPI spec; regenerate with `npm run bundle` from the repo root
* `*.mdx` — Additional hand-written documentation pages beyond the auto-generated API reference

## Workflow

1. Edit the source specification in `Spec/`
2. Run `npm run bundle` to produce the bundled spec
3. The bundled output lands in `api-reference/bundled.yaml` and Mintlify renders it

## Post-bundle transforms

`Spec/`'s `npm run bundle` runs `redocly bundle` and then chains `node ../Mintlify/scripts/apply-coming-soon.js bundled.yaml`.

* **`scripts/apply-coming-soon.js`** — for every operation flagged `x-coming-soon: <timing>` in `Spec/paths/`, prepends a Mintlify `<Warning>` callout to the operation `description` and strips the flag from the bundled output. The flag value is the release-timing phrase, interpolated into the banner sentence. Delete the script and the flags wholesale at GA.