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.Recommended client shape
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.$ref values.