# Compatibility

Within v1 there are only additions: new endpoints, new optional request fields, new response fields and new enum
values. Ignore fields you do not know. Breaking changes come with a new version (`/api/v2`).

The version is part of the path (`/api/v1`). `GET /me` shows it in `api_version`. The complete contract is available as
OpenAPI 3.1 at `GET /openapi.json`, for example to generate a client.

```sh OpenAPI contract
curl https://api.cream-ai.de/api/v1/openapi.json -o mint-api-v1.openapi.json
```
