Addon
Branch restrictions
Branching model
Commit statuses
Commits
Deployments
Downloads
Issue tracker
Pipelines
Projects
Pullrequests
Refs
Reports
Repositories
Snippets
Source
Ssh
Teams
Users
Webhooks
Workspaces
Other operations

Rate this page:

Addon

The addon resource is intended to use used by Bitbucket Cloud Connect Apps, and only supports JWT authentication.

Update an installed app

PUT /2.0/addon

Updates the application installation for the user.

This endpoint is intended to be used by Bitbucket Connect apps and only supports JWT authentication -- that is how Bitbucket identifies the particular installation of the app. Developers with applications registered in the "Develop Apps" section of Bitbucket Marketplace need not use this endpoint as updates for those applications can be sent out via the UI of that section.

A new, valid descriptor must be provided in the body of the PUT request.

1
2
3
4
$ curl -X PUT https://api.bitbucket.org/2.0/addon \
  -H "Authorization: JWT <JWT Token>" \
  --header "Content-Type: application/json" \
  --data '{"descriptor": $NEW_DESCRIPTOR}'

Note that the scopes of the application cannot be increased in the new descriptor nor reduced to none.

OAuth scopes required
None

Request

There are no parameters for this request.

Example

1
2
3
curl --request PUT \
  --url 'https://api.bitbucket.org/2.0/addon' \
  --header 'Authorization: Bearer <access_token>'

Responses

Request has succeeded. The installation has been updated to the new descriptor.

Delete an app

DELETE /2.0/addon

Deletes the application for the user.

This endpoint is intended to be used by Bitbucket Connect apps and only supports JWT authentication -- that is how Bitbucket identifies the particular installation of the app. Developers with applications registered in the "Develop Apps" section of Bitbucket Marketplace need not use this endpoint as updates for those applications can be sent out via the UI of that section.

1
2
$ curl -X DELETE https://api.bitbucket.org/2.0/addon \
  -H "Authorization: JWT <JWT Token>"
OAuth scopes required
None

Request

There are no parameters for this request.

Example

1
2
3
curl --request DELETE \
  --url 'https://api.bitbucket.org/2.0/addon' \
  --header 'Authorization: Bearer <access_token>'

Responses