v1

latestOpenAPI 3.0.0MIT License2026-07-1767200.5 KB

graphql

GraphQL query/mutation

Execute a GraphQL operation. Accepts the standard GraphQL request envelope (query, optional variables, operationName, extensions). Authentication is optional: an admin secret grants admin role; a valid JWT bearer grants the user's role; anonymous requests are served with the public role.

post/v1/graphql

Request body

querystring required

GraphQL document text

operationNamestring nullable

Operation to execute when the document defines more than one

variablesobject nullable

Variable bindings referenced by the document

extensionsobject nullable

Protocol extensions (persisted queries, tracing toggles, ...)

Response

GraphQL response envelope (may carry partial data + errors)

{"stackTrail":"components:schemas:GraphQLResponse:properties:data","oasType":"schema","type":"unknown","description":"Operation result; null on total failure","nullable":true}

extensionsobject

Protocol extensions (tracing, persisted-query acks, ...)