Skip to main content
Chart definitions served to the simulation UI (feature-gated: enable_chart_definitions)

Endpoints


List chart definitions

GET /api/v1/chart-definitions Returns every chart definition stored on this platform as a bare body, ordered by id, under one schema version. The set is bounded server-side and is therefore unpaginated: a client needs all of it atomically under a single schemaVersion. A reader names the newest chart-definition schema version it parses in the schemaVersion query parameter; each chart is served at the highest stored body version that does not exceed it, and a request without the parameter is served chart-definition/v1.

Parameters

Responses

200 - The platform’s chart definitions
400 - The schemaVersion query parameter is malformed or repeated 401 - Unauthorized 404 - Endpoint not served: this platform’s release predates it, or it runs with enable_chart_definitions off. No handler is mounted on either path, so this status carries no body. 500 - The definitions could not be read, or the set breached a served bound and was refused whole 504 - The read exceeded the server-side statement budget and was cancelled