> For the complete documentation index, see [llms.txt](https://docs.butlr.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.butlr.io/data-center/api-reference.md).

# API reference

The Data Center Organization API is a read-only, organization-scoped interface at `https://api.datacenter.butlr.io`.

| Method | Path                              | Purpose                      |
| ------ | --------------------------------- | ---------------------------- |
| `POST` | `/graphql`                        | Query organization inventory |
| `GET`  | `/v1/sensors/{key}/frames`        | Read archived thermal frames |
| `POST` | `/v1/thermal/stats`               | Read thermal statistics      |
| `POST` | `/v1/thermal/events`              | Read derived thermal events  |
| `GET`  | `/v1/thermal/alerts`              | List thermal alerts          |
| `GET`  | `/v1/thermal/alerts/{id}`         | Read a thermal alert         |
| `GET`  | `/v1/thermal/alerts/{id}/context` | Read thermal alert context   |

All requests require an Organization API Token in the `Authorization: Bearer dc_live_...` header. GraphQL mutations and unlisted routes are denied.

The complete OpenAPI 3.1 specification contains request parameters, schemas, examples, and response contracts:

{% file src="/files/3qdeMrqHYvKDubQuAeLO" %}

Use the task-oriented guides in this section for authentication, discovery, raw frames, analytics, alerts, and full client examples.
