Feeling bold?
Sentry's Docs BotAsk A Bot
Product
API
Changelog
Sandbox
Sign In

Create a New Deploy for an Organization

POST /api/0/organizations/{organization_slug}/releases/{version}/deploys/

Create a deploy.

Path Parameters

organization_slug (string)
REQUIRED

The slug of the organization.

version (string)
REQUIRED

The version identifier of the release.

Body Parameters

environment (string)
REQUIRED

The environment you're deploying to.

url (string)

The optional URL that points to the deploy.

name (string)

The optional name of the deploy.

projects (array(string))

The optional list of projects to deploy.

dateStarted (string)

An optional date that indicates when the deploy started.

dateFinished (string)

An optional date that indicates when the deploy ended. If not provided, the current time is used.

Scopes

<auth_token> requires one of the following scopes:
  • project:releases
curl https://sentry.io/api/0/organizations/{organization_slug}/releases/{version}/deploys/ \
 -H 'Authorization: Bearer <auth_token>' \
 -H 'Content-Type: application/json' \
 -d '{"environment":"prod"}'
RESPONSESCHEMA
{
  "environment": "prod",
  "name": null,
  "url": null,
  "dateStarted": null,
  "dateFinished": "2020-08-31T19:40:38.651670Z",
  "id": "1234567"
}