Does install_bitbucket work with (new, required) API tokens with scopes? #844

Activity

1. tersmitten commented on Feb 3, 2026

   

   tersmitten

   on Feb 3, 2026

   Author

   More actions

   Sys.setenv(BITBUCKET_USER = 'foo')
   Sys.setenv(BITBUCKET_PASSWORD = 'App password')
   
   devtools::install_bitbucket(repo = "bar/r-helpers")
   # works
   
   Sys.setenv(BITBUCKET_USER = 'foo')
   Sys.setenv(BITBUCKET_PASSWORD = 'API token with scopes')
   
   devtools::install_bitbucket(repo = "bar/r-helpers")
   # does not work
   #
   # Error: Failed to install 'unknown package' from Bitbucket:
   #  cannot open URL 'https://api.bitbucket.org/2.0/repositories/bar/r-helpers/src/HEAD/DESCRIPTION'
2. tersmitten commented on Mar 13, 2026

   

   tersmitten

   on Mar 13, 2026

   Author

   More actions

   [Action required] App passwords deprecation notice
   

   I'm I the only one using Bitbucket, or is this project dead?
3. tstev commented on Mar 26, 2026

   

   tstev

   on Mar 26, 2026

   Last edited by tstev

   More actions

   Hello Mischa!

   Unfortunately, imho, my work also uses Atlassian products including Bitbucket. I got this to work by setting auth_user to my Bitbucket email and BITBUCKET_PASSWORD to an API token with the following scopes:

   • read:respository:bitbucket
   • write:respository:bitbucket
   • read:pullrequest:bitbucket
   • write:pullrequest:bitbucket

   So this work for me again using remotes:

   remotes::install_bitbucket(
     "<workspace>/<repo>", 
     auth_user = "me@email.com"
   )

   Unfortunately using ref to select a particular branch like feature/new doesn't work and results in the same error you see. It works with main but I think - not sure - the slash in the branch name throws off the API? I worked around that by having a little helper function that converts the ref to a commit id and that works.

   Something along the lines of:

   httr2::request("https://api.bitbucket.org/2.0/repositories/<workspace>/<repo>/refs/branches/<ref>") |>
     httr2::req_auth_basic(Sys.getenv("BITBUCKET_EMAIL"), Sys.getenv("BITBUCKET_PASSWORD")) |>
     httr2::req_perform() |>
     httr2::resp_body_json() |>
     purrr::pluck("target", "hash")

   Hopefully this works for you too!
4. tersmitten commented on Mar 26, 2026

   

   tersmitten

   on Mar 26, 2026

   Author

   More actions

   Thanks for adding your findings, I'll check if I can get it working like this too.

   👍React with 👍1Reacted by Tomas Stevens
5. tersmitten commented on Apr 27, 2026

   

   tersmitten

   on Apr 27, 2026

   Author

   More actions

   An API token with the scopes above also worked for me, but I needed to change Sys.setenv(BITBUCKET_USER = 'username') to Sys.setenv(BITBUCKET_USER = 'email-address'). No need to set auth_user = "me@email.com" in the install_bitbucket call.

   👍React with 👍1Reacted by Tomas Stevens
6. tersmitten commented on Apr 27, 2026

   

   tersmitten

   on Apr 27, 2026

   Author

   More actions

   1: `install_bitbucket()` was deprecated in devtools 2.5.0.
   ℹ Please use `remotes::install_bitbucket()` instead.
   
7. tersmitten

   closed this as completedon Apr 27, 2026