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

# API changelog

> Changes to the Heyrafiki API, newest first.

Changes to the API, its resources and its webhooks. Product and website changes are on the [Heyrafiki changelog](https://heyrafiki.space/changelog).

Breaking changes ship behind a new version. Additive changes, new fields, new event types and new endpoints, ship without one, so build clients that ignore unknown fields.

<Update label="24 July 2026" description="v1 contract published" tags={["Added"]}>
  **Added** the `v1` base URL at `https://api.heyrafiki.space/v1`.

  **Added** key authentication over `Authorization: Bearer`, with `x-api-key` accepted as an alternative. Keys are environment-scoped by prefix, `sk_test_` and `sk_live_`.

  **Added** the error envelope, with a stable `error.code`, a human `error.message` and an `error.docs` link. `401` responses carry `WWW-Authenticate` distinguishing a missing key from a rejected one.

  **Added** the six core resources, Person, Practitioner, Session, Note, Claim and Ledger entry, and the Session lifecycle they move through.

  **Added** the webhook event catalogue and HMAC-SHA256 signing over the raw body.
</Update>