Deprecation policy

Ably’s SDKs are regularly updated to add support for new features, bugfixes, and to accommodate version or API changes in dependencies. Whilst Ably ensures changes are backwards-compatible wherever possible, there are some instances where the previous API structure is no longer suitable.

In all cases, updates to SDKs conform to semantic versioning guidelines. It is recommended that you always update to the latest version of an SDK when it is available.

This policy applies to the following:

Ably SDKs and associated APIs, including;

  • HTTP APIs
  • Ably’s realtime protocol

Ably will support all releases for at least 12 months from the date of release of a version that supersedes it. For example, if version 1.1.0 is released on 1st January 2025, version 1.0.X will be supported until at least 1st January 2026.

Releases will be always be deprecated within 24 months of being superseded.

The sunset date is the date on which a version of an SDK or API will no longer function, at the end of the deprecation period. Ably will usually sunset features by a process of rejecting just a (gradually increasing) proportion of requests to avoid large-scale disruption where possible. However, this won’t always be the case, so you should assume that features or versions will stop working on the sunset date.

Ably will no longer provide the following when a version is deprecated:

  • Technical support for that version.
  • Bugfixes for that version.

Ably also reserves the right to withhold Service Level Agreement (SLA) remedies in the case of service failure, if the use of the deprecated version is believed to be a contributing factor in that failure.