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

# API Versioning

> How Fanvue API versioning works and how to pin the version your app uses.

API versioning ensures backward compatibility and allows us to introduce improvements without breaking existing integrations.

The current version of the Fanvue API is `2025-06-26`.

## Version Header

All API requests must include the `X-Fanvue-API-Version` header to specify which version of the API you want to use.

```bash theme={null}
curl -H "X-Fanvue-API-Version: 2025-06-26" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  https://api.fanvue.com/users/me
```

## Error Responses

**400 Bad Request** - When requesting an unsupported version:

```json theme={null}
{
  "error": "Unsupported API version",
  "message": "API version '2024-01-01' is not supported"
}
```

**410 Gone** - When requesting a sunset (removed) version:

```json theme={null}
{
  "error": "API version no longer supported",
  "message": "API version '2024-01-01' was sunset on 2024-12-31T00:00:00.000Z",
  "nextVersion": "2025-06-26"
}
```

## Dive deeper

For advanced version management strategies, migration patterns, and production best practices, check out our [Version Management Strategies](/docs/versions/management-strategies).