Skip to main content
Permutive’s APIs are versioned to ensure that your applications continue to work as expected as the platform evolves. All API requests require specifying an API version. The version of the API is specified in the URL at the leftmost (highest) scope of the path: 
curl https://api.permutive.app/{version}... \
  ...
Version numbers follow Semantic Versioning. In short, this means that versions that have the same MAJOR number are backwards compatible. For instance, v2.0 and v2.1 are guaranteed to be backwards compatible, but v2.1 adds new features and/or routes. Versions v2.x and v3.x are not guaranteed to be backwards compatible.
The current version of the Permutive API is v2.0.
Fixes, improvements, and additions for a given version of the API are made in a backwards-compatible manner to ensure each version has a stable interface across its lifetime. While we don’t expect public endpoints to change greatly, keep in mind that the API is continuously under development.