Meta
The unversioned landing page (/) and this document's own /v1/api-docs/openapi.json — reachable with no bearer token, since a client needs the document before it can know how to authenticate at all. Not part of the API's versioned data contract, same as Health.
2 endpoints
A branded HTML page linking to the hosted API reference.
get/Requires a bearer token
Not part of the versioned API surface, and reachable with no bearer token at all — a visitor needs this page before they can know how to authenticate against anything else here.
Responses
| Status | Body | Description |
|---|---|---|
| 200 | — | A branded HTML page linking to the hosted API reference. |
| 500 | ErrorBody | An unexpected internal error. error is always internalError; message is deliberately the fixed string "an unexpected error occurred", never the real cause, which is logged server-side instead of being returned to the caller. |
This service's own OpenAPI 3 document.
get/v1/api-docs/openapi.jsonRequires a bearer token
Exactly what's served here — every client that generates against this API reads it from this endpoint. Reachable with no credential, since a client needs this document before it can know how to authenticate against anything else.
Responses
| Status | Body | Description |
|---|---|---|
| 200 | — | This service's own OpenAPI 3 document, exactly as served here. |
| 500 | ErrorBody | An unexpected internal error. error is always internalError; message is deliberately the fixed string "an unexpected error occurred", never the real cause, which is logged server-side instead of being returned to the caller. |