API Versioning

Overview

The Ittybit API uses date-based versioning. e.g. 2025-01-01

We try to minimise breaking changes to the API, but will release a new version whenever a backwards-incompatible change is made.

Default Version

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

The current default version is 2025-07-01.

Specify a Version

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

const response = await fetch(`https://api.ittybit.com/files`, {
  headers: {
    "Accept-Version": "2025-01-01",
    // ... other headers
  },
});

Available Versions

Available API versions and a list of all updates can be found in our 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.