Showing results for 
Search instead for 
Did you mean: 
Sign up Log in

It's not the same without you

Join the community to find out what other Atlassian users are discussing, debating and creating.

Atlassian Community Hero Image Collage

Is there an API call for adding SSH keys to a BitBucket repo?

Is there a REST API or other mechanism that I can use to programmatically add a public key to a specific repository in BitBucket? The end goal would be to add a public key to BitBucket for either a user or a specific repo without having to manually copy and paste the key into the GUI

2 answers

0 votes

There is a REST endpoint that you can use:

To add an SSH key to the current user


    "text": "ssh-rsa AAAAB3... me@",
    "label": "me@"

to <bitbucket-baseurl>/rest/ssh/latest/keys

(label is optional)

To add an SSH key to a repository


    "key": {
        "text": "ssh-rsa AAAAB3... me@",
"label": "some-label" }, "permission": "REPO_WRITE" }

to <bitbucket-baseurl>/rest/ssh/latest/projects/<project-key>/repos/<repo-slug>

You can find all SSH endpoints in the Bitbucket Server Docs under the REST documentation for SSH keys under 

Perfect! This is exactly what I needed - thanks very much for sending that over. I'll give it a try and let you know if I have any issues. Thanks again!

Is the documentation website for the REST documentation for SSH keys down? I'm attempting to access it and am getting the below error. I've also included the URL (accessed by clicking the link that you provided) I'm attempting to access should that prove useful.  I also attempted to access the documentation for my version of bitbucket (4.9.1) and also got a 404 but with a different output. If this API and its documentation is substantially different from the current version, can you please provide a link to that as well? Thanks in advance for your time and attention to this matter.

404 Not Found

  • Code: NoSuchKey
  • Message: The specified key does not exist.
  • Key: DAC/rest/bitbucket-server/5.6.2/bitbucket-ssh-rest.html
  • RequestId: B8A857E92F5D8C73
  • HostId: +Be8+F3ofVltMDPPCvB4aZE/xvfvIT+iQSSgWvU70MBReRPOctL08IM1Ae6cUgAcfRvdnRwmJAg=

An Error Occurred While Attempting to Retrieve a Custom Error Document

  • Code: NoSuchKey
  • Message: The specified key does not exist.
  • Key: error.html


 I am trying to add the key to the repository with REPO_WRITE permission, but it looks like it ignores permission and forcibly add the key with REPO_READ permission.

 Should the user have some special permissions to add the key with  REPO_WRITE permission? 

Just for future reference: the REST documentation for SSH keys is not down, but the URL has changed a bit. Here is the currently working URL:

Would this also work on the hosted repo's? 

0 votes
jredmond Atlassian Team Dec 18, 2017

Bitbucket Server or Bitbucket Cloud?

Bitbucket server

Suggest an answer

Log in or Sign up to answer
Community showcase
Published in Bitbucket

New improvements to user management in Bitbucket Cloud 👥

Hey Community! We’re willing to wager that quite a few of you not only use Bitbucket, but administer it too. Our team is excited to share that we’ll be releasing improvements throughout this month of...

3,927 views 10 16
Read article

Community Events

Connect with like-minded Atlassian users at free events near you!

Find an event

Connect with like-minded Atlassian users at free events near you!

Unfortunately there are no Community Events near you at the moment.

Host an event

You're one step closer to meeting fellow Atlassian users at your local event. Learn more about Community Events

Events near you