# API reference

The control plane's HTTP API, for building, testing, releasing and deploying Decisions from your own code.

Everything the app and your agents do to build, test, release and deploy Decisions goes through this API, at `https://api.typefuse.dev`. Your own code and CI can use it too.

Each request carries a personal access token as `Authorization: Bearer <token>`, and can do what the token's access allows: **Read**, **Run** or **Full**. Bodies and answers are JSON. A refusal answers with its HTTP status and `{ "code", "message", "details" }`, where `details`, when there is one, says more. 402 FAIR_USE_REACHED means the organisation has used what its plan includes of the Definition assistant for now; `details.resetsAt` says when it can be asked again.

Calls to deployed Decisions go to the runtime instead: see the Runtime API.

- [Try it in the API console](https://api.typefuse.dev/docs)
- [Runtime API](https://typefuse.dev/guides/runtime-api)
- [Personal access tokens](https://typefuse.dev/guides/agents#ci-and-scripts)

- [API: Organisations](https://typefuse.dev/guides/api-organisations): Who a token acts as, and the organisations it reaches.
- [API: Decisions and drafts](https://typefuse.dev/guides/api-decisions): Create Decisions, write and check their drafts, and work with the Definition assistant.
- [API: Versions and models](https://typefuse.dev/guides/api-versions): Publish versions, run them, and try a newer model before you move to it.
- [API: Examples, Test sets and Evaluations](https://typefuse.dev/guides/api-tests): Worked Examples, Test set cases, Test runs and the Evaluations that read them.
- [API: Datasets and Comparisons](https://typefuse.dev/guides/api-comparisons): Upload or replay Datasets and compare two releases over them.
- [API: Deployments](https://typefuse.dev/guides/api-deployments): Environments and what each serves: deploy, check, cancel and remove releases.
- [API: Runs and audit](https://typefuse.dev/guides/api-runs): Recorded calls, the Change history and exports of both.
