> ## Documentation Index
> Fetch the complete documentation index at: https://www.canva.dev/docs/apps/llms.txt
> Use this file to discover all available pages before exploring further.

# 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](https://www.canva.dev/docs/apps/deprecation-policy/#canva-rest-apis).

For a list of API versions and a log of breaking and non-breaking changes, see the [Changelog](https://www.canva.dev/docs/apps/rest-apis/changelog/).

For how to manage which REST API version your app uses, see [Canva REST API versioning](https://www.canva.dev/docs/apps/rest-apis/manage-versions/).

WARNING: Breaking changes made to APIs and features that are marked as "Beta" or "Preview" won't produce a new API version.

NOTE: 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.