Deprecation notice - Removing project:write scope from Bitbucket Cloud API on 15 May 2023

Summary

Beginning 15 May 2023, we are removing the project:write scope from the Bitbucket Cloud API. If you are using the project:write scope in your integration/application, read on.

What action is required?

We have released a new scope, project:admin, which means the project:write scope is now obsolete.

• All integrations currently using the project:write scope to call the Project endpoints (listed below) need to start using the project:admin scope.
• All integrations currently using the project:write scope to call the Repository endpoints (listed below) or Git LFS need to start using the repository scope.

Which API endpoints are affected?

Project endpoints

• POST /2.0/workspaces/{workspace}/projects
• PUT /2.0/workspaces/{workspace}/projects/{project_key}
• DELETE /2.0/workspaces/{workspace}/projects/{project_key}

Repository endpoints

Branching model

• GET /2.0/repositories/{workspace}/{repo_slug}/branching-model

Commit statuses

• PUT /2.0/repositories/{workspace}/{repo_slug}/commit/{commit}/statuses/build/{key}
• GET /2.0/repositories/{workspace}/{repo_slug}/commit/{commit}/statuses/build/{key}
• POST /2.0/repositories/{workspace}/{repo_slug}/commit/{commit}/statuses/build
• GET /2.0/repositories/{workspace}/{repo_slug}/commit/{commit}/statuses

Downloads

• GET /2.0/repositories/{workspace}/{repo_slug}/downloads
• GET /2.0/repositories/{workspace}/{repo_slug}/downloads/{filename}

Commits

• GET /2.0/repositories/{workspace}/{repo_slug}/commit/{commit}
• GET /2.0/repositories/{workspace}/{repo_slug}/commits
• POST /2.0/repositories/{workspace}/{repo_slug}/commits
• GET /2.0/repositories/{workspace}/{repo_slug}/commits/{revision}
• POST /2.0/repositories/{workspace}/{repo_slug}/commits/{revision}
• GET /2.0/repositories/{workspace}/{repo_slug}/commit/{commit}/comments
• POST /2.0/repositories/{workspace}/{repo_slug}/commit/{commit}/comments
• GET /2.0/repositories/{workspace}/{repo_slug}/commit/{commit}/comments/{comment_id}
• GET /2.0/repositories/{workspace}/{repo_slug}/diff/{spec}
• GET /2.0/repositories/{workspace}/{repo_slug}/diffstat/{spec}
• GET /2.0/repositories/{workspace}/{repo_slug}/patch/{spec}
• GET /2.0/repositories/{workspace}/{repo_slug}/merge-base/{revspec}

Source

• GET /2.0/repositories/{workspace}/{repo_slug}/filehistory/{commit}/{path}
• GET /2.0/repositories/{workspace}/{repo_slug}/src
• GET /2.0/repositories/{workspace}/{repo_slug}/src/{commit}/{path}

Deployments

• GET /2.0/repositories/{workspace}/{repo_slug}/deploy-keys
• POST /2.0/repositories/{workspace}/{repo_slug}/deploy-keys
• GET /2.0/repositories/{workspace}/{repo_slug}/deploy-keys/{key_id}
• PUT /2.0/repositories/{workspace}/{repo_slug}/deploy-keys/{key_id}
• DELETE /2.0/repositories/{workspace}/{repo_slug}/deploy-keys/{key_id}

Refs

• GET /2.0/repositories/{workspace}/{repo_slug}/refs
• GET /2.0/repositories/{workspace}/{repo_slug}/refs/tags
• GET /2.0/repositories/{workspace}/{repo_slug}/refs/tags/{name}
• GET /2.0/repositories/{workspace}/{repo_slug}/refs/branches
• GET /2.0/repositories/{workspace}/{repo_slug}/refs/branches/{name}

Repositories

• GET /2.0/repositories/{workspace}/{repo_slug}
• GET /2.0/repositories/{workspace}
• GET /2.0/repositories
• GET /2.0/repositories/{workspace}/{repo_slug}/forks
• GET /2.0/repositories/{workspace}/{repo_slug}/watchers

Workspaces

• GET /2.0/workspaces/{workspace}/permissions/repositories

What else is affected?

Git LFS