v1

latestSwagger 2.0MIT2026-08-06120162320.1 KB

app-setup

Add a new app

Add a new app to Bitrise. This is the first step of the app registration process. To successfully set it up, you need to provide the required app parameters: the repository URL and the isPublic field. Read more about the app creation process in our detailed guide.

post/apps/register

Request body

default_branch_namestring

The default branch of the repository. If it's not specified, it will be master.

git_ownerstring

[Deprecated] You no longer need to provide this field.

git_repo_slugstring

[Deprecated] You no longer need to provide this field.

is_publicboolean required

If true then the repository visibility setting will be public, in case of false it will be private

manual_approval_enabledboolean

Toggles whether manual approval should be enabled for the app's builds. If it's not specified, it will be true.

organization_slugstring

The slug of the organization, who will be the owner of the application. If it's not specified, then the authenticated user will be the owner.

providerstring

The git provider you are using, it can be github, bitbucket, gitlab, gitlab-self-hosted or custom

repo_urlstring required

The URL of your repository

titlestring

The title of the application. If it's not specified, it will be the git repository's name.

typestring

[Deprecated] You no longer need to provide this field.

Response

slugstring

statusstring