The API reference is designed for Mintlify’s OpenAPI workflow. When the canonical OpenAPI 3.1 specifications are added to docs.json, Mintlify can generate endpoint pages, request builders, response schemas, and SDK examples from the spec.

​
Current references

OpenAgent SDK

High-level language APIs.

Arsenal Broker

Credential proxy endpoints.

Main specification

OAS v1.1.0 on the main site.

AEGIS verification

Verification pipeline and policy checks.

​
OpenAPI readiness

The docs project is already structured for generated references:
  • Add OpenAPI 3.1 JSON or YAML files under docs/openapi/.
  • Reference them from docs.json using Mintlify’s openapi navigation field.
  • Keep hand-written guides in the same API tab for concepts and authentication.
  • Run mintlify broken-links and mintlify openapi-check in CI before publishing.