Widget and REST API Versioning

When we introduce backward-incompatible changes into Uploadcare Widget and REST API, we release new major versions. Once published, such versions are supported for a limited time period. This section combines versions, their publishing dates, and support terms.

Management of Releases

The support length for each new release of Uploadcare Widget and REST API is 2 years. The two-year support term for current versions starts when we release the new ones. We will update this document, our changelog, and notify you via email about new releases.

Latest Versions

The latest versions are:

  • Uploadcare Widget: 3.7.7
  • REST API: 0.5

The relevant documentation for latest versions can be found here: Widget Docs, REST API Reference.

The complete log of changes can be found in the platform Changelog under the tags “widget” and “rest api”.

Uploadcare Widget, Versioning

VersionDate PublishedSupported Until
3.x28 Jun 2017TBD
2.x20 Feb 20151 Jan 2020
1.x21 Mar 20141 Jun 2019
0.x6 Sep 20121 Jun 2019

Note, you will still be able to use any widget version after its support term. However, you will be acting at your own risk.

The history of widget 3.x and 2.x changes can be found on GitHub. To migrate from 2.x to 3.x, check out this migration guide.

REST API, Versioning

VersionDate PublishedAvailable Until
0.51 Apr 2016TBD
0.413 Jun 20151 Sep 2019
0.311 Jun 20131 Sep 2019
0.27 Jun 20121 Sep 2019
0.131 May 20121 Feb 2019
Undefined31 May 20121 Sep 2019

Note, you won’t be able to use any API version after its support term. Requests to deprecated API versions will return error messages.