OpenAPI generation

Basedoc is the only platform that auto-generates OpenAPI specifications based on your API documentation pages.

Every API endpoint page you create is compiled into an OpenAPI specification, and added to the project's OpenAPI specification.

OpenAPI files are available in YAML and JSON formats at /openapi.yaml and /openapi.json on your hosted site's domain. For example yoursite.com/docs/openapi.yaml or yoursite.basedoc.io/openapi.json.

You can then use these generated spec files in your API clients, or in your AI agents.

Importing OpenAPI files

You will soon be able to import OpenAPI files into your Basedoc project, to generate API documentation pages.