Update an Organization's Release

PUT /api/0/organizations/{organization_slug}/releases/{version}/

Update a release for a given organization.

Path Parameters

organization_slug (string)

The slug of the organization the release belongs to.

version (string)

The version identifier of the release.

Body Parameters

ref (string)

An optional commit reference. This is useful if a tagged version has been provided.

url (string)

A URL that points to the release. This can be the path to an online interface to the source code for instance.

dateReleased (string)

An optional date that indicates when the release went live. If not provided the current time is assumed.

commits (array)

An optional list of commit data to be associated with the release. Commits must include parameters id (the sha of the commit), and can optionally include repository, message, author_name, author_email, and timestamp.

refs (array)

An optional way to indicate the start and end commits for each repository included in a release. Head commits must include parameters repository and commit (the HEAD sha). They can optionally include previousCommit (the sha of the HEAD of the previous release), which should be specified if this is the first time you've sent commit data.


<auth_token> requires one of the following scopes:
  • project:releases
curl https://sentry.io/api/0/organizations/{organization_slug}/releases/{version}/ \
 -H 'Authorization: Bearer <auth_token>' \
 -X PUT \
 -H 'Content-Type: application/json' \
 -d '{"ref":"freshtofu","url":"https://vcshub.invalid/user/project/refs/freshtofu"}'
  "id": 2,
  "authors": [],
  "commitCount": 0,
  "data": {},
  "dateCreated": "2019-01-03T00:12:55.109Z",
  "dateReleased": null,
  "deployCount": 0,
  "firstEvent": null,
  "lastCommit": null,
  "lastDeploy": null,
  "lastEvent": null,
  "newGroups": 0,
  "owner": null,
  "projects": [
      "name": "Pump Station",
      "slug": "pump-station"
  "ref": "6ba09a7c53235ee8a8fa5ee4c1ca8ca886e7fdbb",
  "shortVersion": "2.0rc2",
  "url": null,
  "version": "2.0rc2"