Issue
When I try to delete a release with the Sentry CLI or API, I get this error:
This release is referenced by active issues and cannot be removed. (http status: 400)
I want to remove a release that I no longer need.
Applies To
All SaaS Customers and Self-Hosted Users
Releases
Resolution
You cannot delete that release while it is still referenced by active issues. Archive the release instead if you want it hidden from the default Releases UI.
Sentry blocks deletion in these cases:
This release is referenced by active issues and cannot be removed.
At least one issue still has this release set as its first release.This release has health data and cannot be removed.
The release has release health / session data. Sentry blocks deletion because that health data would recreate the release.
If neither condition applies, you can delete the release with the API or CLI. Sentry permanently removes the release and its files. If a later event arrives with the same release version, Sentry creates the release again. For that reason, archiving is the usual approach when you only want the release out of the way.
Archive a release
In Sentry, open Releases, open the release, and archive it.
Or run:sentry-cli releases archive VERSION
Archived releases stay hidden unless you change the Releases filter to show archived releases.
For details, see Archive a Release. To bring an archived release back, see Restore a Release.