# Versioning

There is one API version, `v1`, and it is part of the path.

## Overview

API endpoints live under `/v1/`; `GET /health` and a few web pages, such as the password-reset page, are outside it. The API doesn't read a version header and doesn't send `Deprecation` or `Sunset` headers.

## Building for Change

- Ignore response fields you don't know, so that new fields don't break your client.
- Treat status values you don't recognise as not final, and read the resource again before acting — see [Enums & State Machines](https://docs.aureahub.com/docs/enums-states.md).
- Don't depend on the wording of error `message` fields; branch on the HTTP status and, where present, `code` — see [Error Handling](https://docs.aureahub.com/docs/errors.md).

---

Web version: https://docs.aureahub.com/#versioning