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

# Versioning

folk's API uses versioning to ensure backward compatibility. By default, every request is made to the latest version of the API.
You can specify the API version you want to use through the `X-API-Version` header.

```
{
  "X-API-Version": "2025-05-26"
}
```

Providing an invalid version will return a `400 Bad Request` error.

It's recommended to always specify the API version in your requests to avoid unexpected changes in the request or response format.

We strive to improve the API and add new features regularly. Every time a breaking change is introduced, a new version of the API is released.
You can find the list of changes in the [changelog](/changelog) section.

## Endpoint availability

We ensure that each endpoint remains available for at least **1 year** from its release date. When we plan to remove or replace an endpoint, we provide a **6-month deprecation notice** before it is discontinued. Deprecation notices are published in the [changelog](/changelog).