For the complete documentation index, see llms.txt. Markdown versions are available by appending .md to page URLs.
The Mintlify site is configured by docs/docs.json. Pages are Markdown or MDX files in docs/, and the HTTP reference is generated from docs/openapi.yaml.
Preview locally
Run from the documentation directory:http://localhost:3000 and reloads as files change.
Validate
docs.json, navigation paths, MDX syntax, links, and the OpenAPI document.
Add a page
- Create a
.mdxfile underdocs/withtitleanddescriptionfrontmatter. - Add its extensionless path to the appropriate group in
docs/docs.json. - Use root-relative links such as
/configurationfor internal navigation. - Run
npx mint validatebefore opening a pull request.
Update the HTTP reference
Editdocs/openapi.yaml when a versioned route, parameter, request body, response, or permission changes. Endpoint entries in docs/docs.json use the exact METHOD /path form and must match the OpenAPI operation.
Keep handwritten behavior and security guidance in the overview pages. Keep operation-specific parameters and schemas in the OpenAPI document so generated pages stay consistent.
Deployment
Connect the repository to a Mintlify project and set the documentation directory todocs. Mintlify deploys changes after they reach the configured production branch. Domain configuration and deployment status live in the Mintlify dashboard, not this repository.