Skip to main content

Raw YAML content of the OpenAPI 3.0 spec

GET 

/openapi.yaml

Returns this API's OpenAPI 3.0 spec as raw YAML. No auth required — the endpoint list and schemas are documentary in nature, not secret.

Use cases:

  • The dev test panel (/dev/docs.html) renders this with Swagger UI.
  • Import into tools like Postman / Insomnia.
  • SDK / client code generators (openapi-generator etc.).

Cache: ETag + 5 minutes Cache-Control: public, max-age=300. The spec rarely changes; the browser gets a cheap 304 Not Modified response.

Responses

YAML content of the OpenAPI 3.0 spec

Response Headers
    ETag

    16-char MD5 prefix; used with If-None-Match to return 304.

    Cache-Control