> ## Documentation Index
> Fetch the complete documentation index at: https://docs.refmatter.com/llms.txt
> Use this file to discover all available pages before exploring further.

# API overview

> Base URL, versioning, authentication, and conventions shared by every endpoint.

* **Base URL:** `https://api.refmatter.com`
* **Versioning:** all product endpoints live under `/v1`. Additive changes ship without a version bump; breaking changes get `/v2`.
* **Authentication:** `Authorization: Bearer <workspace API key>` for machines, session cookies for people. See [Authentication](/guides/authentication).
* **Content type:** JSON in, JSON out. Timestamps are RFC 3339 UTC. Ids are UUIDs.
* **Idempotency:** `POST /v1/ingestions` requires an `Idempotency-Key` header.
* **Errors:** one envelope with a stable `code`; see [Errors](/guides/errors).
* **Contract:** the machine-readable source of truth is `GET https://api.refmatter.com/openapi.json`. Every operation carries `x-implementation-status`; only `implemented` operations are availability claims.