API versions
The Canva REST APIs are versioned with a date-based version. This allows Canva to make breaking changes to the API without affecting existing apps.
Whenever a breaking change is made, a new REST API version is released with a version identifier based on the change date, for example 2024-01-31. It's anticipated that superseded versions of the API will remain supported for at least 6 months before the old version is deprecated and removed.
For how Canva defines a breaking change to the REST APIs, see Breaking vs. non-breaking changes.
For a list of API versions and a log of breaking and non-breaking changes, see the Changelog.
For how to manage which REST API version your app uses, see Canva REST API versioning.
Breaking changes made to APIs and features that are marked as "Beta" or "Preview" won't produce a new API version.
The version number included in endpoint paths (the v1 in https://api.canva.com/rest/v1/) is not used for the API versioning described in this article. That version indicator is reserved for any future epoch-level changes where the entire API and its architecture might fundamentally change.