Skip to main content

Release Management API

Abstract

Bitrise offers a REST API for Release Management: you can connect apps, configure presets, manage your releases, and distribute the apps via the API.

Bitrise offers a REST API for Release Management. The base URL for the API is https://api.bitrise.io/release-management/v1.

The API offers the same features that are available on the GUI. You can:

  • Connect apps.

  • Configure presets.

  • Manage releases in all stages, including the release candidate stage and the approval stage.

  • Distribute your apps.

Authentication

Authentication works the same way as the Bitrise API: you need a Personal Access Token or a Workspace token to authenticate your API calls.

Certain endpoints are only available to users with the Release manager role and some endpoints are only available on the Standard plan. Typically, these endpoints are used to access end-user-facing functions, such as submitting the app for App Store review and releasing the app to the App Store or Google Play.

Trying to access the endpoints tied to these roles will return a 403 Permission denied response.

Documentation

You can find detailed documentation of the API endpoints: API docs. You can test all endpoints on the site.

In addition to the technical details, you can also check whether an endpoint is available on a given Bitrise payment plan.

Localization codes for the App Store API

For certain calls to the App Store API, you might need localization codes: for example, when creating a What to test description for an iOS release, you might need that description in several different languages. You can find the supported localization codes in Apple's documentation.