Create a New Release for an Organization

Create a new release for the given organization. Releases are used by Sentry to improve its error reporting abilities by correlating first seen events with the release that might have introduced the problem. Releases are also necessary for source maps and other debug features that require manual upload for functioning well.

Path Parameters

organization_slug (string)

The slug of the organization.

Body Parameters

version (string)
ref (string)
url (string)
projects (array)
dateReleased (string)
commits (array)
refs (array)


<auth_token> requires the following scopes:
  • project:releases
POST /api/0/organizations/{organization_slug}/releases/
curl{organization_slug}/releases/ \
 -H 'Authorization: Bearer <auth_token>' \
 -H 'Content-Type: application/json' \
 -d '{"version":"2.0rc2","ref":"6ba09a7c53235ee8a8fa5ee4c1ca8ca886e7fdbb","projects":["pump-station"]}'
  "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"