Anakin.ai API

API Versions

Learn how to specify which API version to use whenever you make a request to the API.

About API versioning

The Anakin.ai API is versioned. The API version name is based on the date when the API version was released. For example, the API version 2024-05-08 was released on Tue, 8 May 2024.

Any breaking changes will be released in a new API version. Breaking changes are changes that can potentially break an integration.

removing an entire operation
removing or renaming a parameter
removing or renaming a response field
adding a new required parameter
making a previously optional parameter required
changing the type of a parameter or response field
removing enum values
adding a new validation rule to an existing parameter
changing authentication or authorization requirements

Any additive (non-breaking) changes will be available in all supported API versions. Additive changes are changes that should not break an integration. Additive changes include:

adding an operation
adding an optional parameter
adding an optional request header
adding a response field
adding a response header
adding enum values

When a new API version is released, the previous API version will usally be supported for at least 3 more months.

Specifying an API version

You should use the X-Anakin-Api-Version header to specify an API version. For example:

curl --header "X-Anakin-Api-Version:2024-05-08" https://api.anakin.ai/v1/versions

Requests without the X-Anakin-Api-Version header will default to use the 2024-05-08 version.

:::caution
If you specify an API version that is no longer supported, you will receive a 422 error.
:::

Supported API versions

The following API versions are currently supported:

2024-05-08

You can also make an API request to get all of the supported API versions. For more information, see "Get all API versions".

Last modified: 6 months ago