# Heyrafiki Docs

> The Heyrafiki API: authentication, errors, resources and webhooks.

## Docs

- [Authentication](https://docs.heyrafiki.space/authentication.md): Authenticate Heyrafiki API requests with a secret key.
- [API changelog](https://docs.heyrafiki.space/changelog.md): Changes to the Heyrafiki API, newest first.
- [How Heyrafiki works](https://docs.heyrafiki.space/concepts/platform.md): The system the API sits on: what each surface does and how a Session moves through it.
- [Errors](https://docs.heyrafiki.space/errors.md): HTTP status codes and the Heyrafiki error envelope.
- [Introduction](https://docs.heyrafiki.space/index.md): The Heyrafiki API: base URL, authentication, errors and resources.
- [Resources](https://docs.heyrafiki.space/resources.md): The objects the Heyrafiki API exposes and how they relate.
- [Security and privacy](https://docs.heyrafiki.space/security/overview.md): What Heyrafiki protects, how access is decided, and what never leaves.
- [Versioning](https://docs.heyrafiki.space/versioning.md): How the Heyrafiki API changes, what counts as breaking, and how long old versions live.
- [Webhooks](https://docs.heyrafiki.space/webhooks.md): Subscribe to Heyrafiki events, verify signatures and handle retries.