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
- 200
- 304
- 404
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
Spec unchanged (If-None-Match matched). Empty body.
docs/openapi.yaml file not found on the server (deploy error)