What is the latest version?
The latest version is2024-02-05
.
Which version am I using?
Your version is stored in your account when you call the API for the very first time. This version is automatically applied to your API calls in the future.
📘 X-Api-Version response header
If you have any uncertainty regarding the API version, checking the X-Api-Version
response header will provide the necessary clarification. This header provides the specific version information associated with the API endpoint you are interacting with.
Setting your API version
Even though a version is stored on your account when you call the API for the first time, it is highly recommended to always specify the API version you intend to use. You can set the API version by including theX-Api-Version
request header.
The value of the header should be set to the dated version of the API version you intend to call. e.g. 2024-02-05
.
Backwards-compatible changes
Runa considers the following changes to be backwards-compatible:- Adding new API resources.
- Adding new optional request parameters to existing API methods.
- Adding new properties to existing API responses.
- Changing the order of properties in existing API responses.
Upgrading your API version
If you’re running against an older version of the API, upgrade to the latest version to take advantage of new functionality or to streamline responses so the API is faster for you. We recommend to follow these steps to successfully upgrade your API version:- Refer to the changelog to see what contract changes the new version introduces. You can also view the full documentation for a chosen version using the dropdown in the header of this site.
- Update the
X-Api-Version
header to the newer version on affected endpoints. Modify your code as per the new API contracts. - Test the changes in the playground environment
- Release to production, you may want to do this in a phased approach to ensure everything is working as expected.
- Notify our support team and we’ll update your account to the newer version as a default version. If you are always setting a version header in your requests, this is entirely optional.