Agent-readable docs index: /llms.txt. Download /docs.zip to grep all markdown files locally.

Request and Response Examples

Generated OpenAPI pages render request and response information based on your spec's schemas.

Request parameters

Query parameters, path parameters, and headers are listed with their type, description, and required/optional status.

Request body

If an operation has a requestBody, Holocron renders the schema as a structured field list. JSON Schema properties become rows with name, type, and description.

Response schemas

Each response status code (200, 201, 400, etc.) is rendered with its schema. Multiple response codes are shown in separate sections.

Examples in the spec

Holocron renders a generated cURL request and the first JSON response example or examples entry in the right-side aside. Schema and parameter examples are still useful context, but they are not rendered as separate aside code blocks today.
paths:
  /users:
    get:
      responses:
        '200':
          description: List of users
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/User'
              example:
                - id: 1
                  name: Alice
                - id: 2
                  name: Bob

Two-column layout

On desktop, the request/response examples appear in the right aside column next to the parameter descriptions. On mobile, they stack below the parameters.
Powered byHolocron