# API Versioning

[View original](https://ittybit.cloud/api/versioning)

## Default Version

Requests with no version specified will always use the most recent stable version available.

**The current default version is `2025-08-20`.**

***

## Specify a Version

We strongly recommend pinning your API requests to a specific version to ensure consistent behavior.

To specify a version for your API request, include an `Accept-Version` header with the desired version date. For example: `"Accept-Version": "2025-08-20"`.

<Tabs items={["request.js", "request.sh"]}>
  <Tab value="request.js">
    ```js
    const response = await fetch(`https://api.ittybit.cloud/files`, {
      headers: {
        "Accept-Version": "2025-01-01",
        // ... other headers
      },
    });
    ```
  </Tab>

  <Tab value="request.sh">
    ```shell
    curl "https://api.ittybit.cloud/files" \
    -H "Accept-Version: 2025-08-20"
    # ... other headers
    ```
  </Tab>
</Tabs>

***

## SDKs

The ittybit SDKs all support versioning via a custom option during initialization, or on a per-request basis.

See [SDK documentation](/sdks) for more information.

***

## Available Versions

Available API versions and a list of all updates can be found in our [Changelog](/changelog).

***

## Deprecation Policy

Older API versions may be deprecated in future.

In those cases we will provide at least 3 months notice and work with you to upgrade to a more recent API version smoothly.

***

## Security Vulnerabilities

In the very rare case that a more urgent update is required – for example, to fix a security vulnerability – we will contact your account admin directly and work with you to upgrade to a more recent API version smoothly.