Exposing Your APIs with openapi.json
To make your documentation content accessible to AI tools, search engines, and developer platforms like Microsoft Copilot, it's helpful to provide a machine-readable API specification using the openapi.json format. This allows external systems to understand how to interact with your help content programmatically.
What is openapi.json?
openapi.json is a standard file based on the OpenAPI Specification that describes your API's endpoints, parameters, responses, and data models in a structured JSON format. Itβs widely supported by developer tools, SDK generators, and AI platforms.
Why Publish an openapi.json File?
- Enables integrations with Microsoft Copilot, ChatGPT, and other AI tools
- Helps developer tools automatically generate SDKs and clients
- Provides a clear structure for third-party systems to access your documentation
- Complements your
ai.txtfile for AI crawler support
HelpGuides Support for openapi.json
HelpGuides fully support openapi.json to describe APIs that AI platforms can consume.
You can find your openapi.json file in the root of your site. For example: