Skip to main content

API Reference

This section is the execution layer: the exact shapes of /guide, /query, authentication, and error responses. If you are writing client code directly (no AI in the middle), this is where you want to be.

If you are here looking for concepts or a mental model, go back to Concepts. If you are building through an AI client, the AI only needs AI Instructions and the YAML specs — not these pages.

In this section​

  • Authentication — how to obtain and send credentials.
  • /guide — the discovery endpoint. Returns live spec, feature flags, and tracking_id list.
  • /query — the execution endpoint. Accepts a QAL query, returns rows.
  • Errors — canonical error codes and what they mean.
  • Examples — worked end-to-end examples you can curl against a live install.