---
title: OpenAPI Support
description: docs-builder can generate API reference pages from an OpenAPI spec. Add an api: entry in docset.yml. Then preview the pages. See API Explorer for configuration,...
url: https://docs-v3-preview.elastic.dev/elastic/docs-builder/pull/3946/data/openapi
products:
  - Elastic Docs Builder
---

# OpenAPI Support
docs-builder can generate API reference pages from an OpenAPI spec.

## API Explorer

Add an `api:` entry in `docset.yml`. Then preview the pages. See [API Explorer](https://docs-v3-preview.elastic.dev/elastic/docs-builder/pull/3946/data/openapi/api-explorer) for configuration, URL paths, and OpenAPI extensions.
To change an operation or tag page, put an `op-*.md` or `tag-*.md` file in `api/<key>/`. See [Writing supplemental content](https://docs-v3-preview.elastic.dev/elastic/docs-builder/pull/3946/data/openapi/supplemental).
```yaml
api:
  elasticsearch:
    - spec: elasticsearch-openapi.json
      product: elasticsearch
```

The map key is the URL suffix. `elasticsearch` produces pages under `/api/doc/elasticsearch/`.