V2
OpenAPI
Use public OpenAPI document and metadata endpoints for generated clients and automation checks.
OpenAPI
The V2 API exposes a machine-readable OpenAPI document and a metadata endpoint for cache validation and automation.
Endpoints
| Endpoint | Description |
|---|---|
GET /v2/openapi.json |
Returns the complete OpenAPI document. |
GET /v2/openapi/meta |
Returns metadata for the OpenAPI document. |
/v2/openapi.json
Use this endpoint for generated clients, SDK generation, contract checks, and tooling. Prefer this machine-readable document over scraping documentation pages.
/v2/openapi/meta
{
"etag": "W/\"openapi-v2-abcdef\"",
"generatedAt": "2026-04-09T09:30:00.000Z",
"pathCount": 22,
"version": "v2"
}
| Field | Description |
|---|---|
etag |
Digest of the serialized OpenAPI document for change detection. |
generatedAt |
Generation or version timestamp in ISO 8601 format. |
pathCount |
Number of paths in the published document. |
version |
API version represented by the document. |
Recommended Usage
- Fetch
metafirst and downloadopenapi.jsononly when theetagchanges. - Use
openapi.jsonas the source for generated clients and CI checks. - Do not reverse-engineer API contracts from prose docs when OpenAPI contains the schema.
Notes
- Both OpenAPI routes are public and do not require a token.
- The OpenAPI document describes public V2 routes only.
- Generated clients should still handle documented error responses.