API versioning policy

Qlik Talend public APIs are considered as a whole and a single version is defined for all endpoints and business domains. The version is incremented only if a breaking change is introduced in an API. In this case, the version is incremented for all APIs.

The version name indicates the year and month of its release, following the pattern YYYY-MM.

Since the JSON response is an unordered collection of fields, the order of fields may change without API version increase. Thus API consumers should never rely on the order of elements.

---

Current version: 2021-03

---

Version support

As soon as a new version is released, the previous version becomes deprecated and is supported for another 18 months. After that, the version is retired and can no longer be used.

By default, the oldest supported version is used in a request if:

• There is no version specified.
• The version specified is retired.
• The version specified does not exist.

Using a specific version in a request

Qlik Talend APIs support two ways of setting an API version in a request:

• In an HTTP header with the key talend-version (recommended)
• In a query parameter with the key talendVersion

In Talend API Tester, you can set the version as follows: