Skip to main content

Generate clients

The committed OpenAPI spec is served from this docs site at /openapi/v2.json. Use it to generate clients for your integration stack.
The spec is generated from the API source before it is pushed, then Mintlify builds the API reference from that same file.

Generate from the docs spec

Wrap generated clients

Generated code is easier to use when auth, base URL, and non-2xx handling live in one wrapper.

Centralize auth

Put client credential handling in one HTTP client wrapper.

Handle non-2xx responses

Treat OAuth errors and v2 error bodies as structured responses.

Regenerate deliberately

Commit generated clients with the spec version that produced them.

Pin your generator

Use a fixed OpenAPI generator version in CI for repeatable output.

Pre-push check

Run the developer docs check before pushing documentation or API reference changes.
This verifies that the generated spec is current, Mintlify can read every referenced page, and the OpenAPI document uses only internal $ref values.