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

Earn badges and make progress

You're on your way to the next level! Join the Kudos program to earn points and save your progress.

Deleted user Avatar
Deleted user

Level 1: Seed

25 / 150 points

Next: Root


1 badge earned


Participate in fun challenges

Challenges come and go, but your rewards stay with you. Do more to earn more!


Gift kudos to your peers

What goes around comes around! Share the love by gifting kudos to your peers.


Rise up in the ranks

Keep earning points to reach the top of the leaderboard. It resets every quarter so you always have a chance!


Come for the products,
stay for the community

The Atlassian Community can help you and your team get more value out of Atlassian products and practices.

Atlassian Community about banner
Community Members
Community Events
Community Groups

Create and configure a Bitbucket Server repository using the REST API endpoints

How to create a repository using the REST API endpoints?

To create a new repository, we will be using the following endpoint:

POST /rest/api/1.0/projects/{projectKey}/repos


When using curl, the full command looks like this:

curl --user <user>:<password> -H "Content-Type: application/json" --data @input.json -X POST <Bitbucket URL>/rest/api/1.0/projects/<projectKey>/repos


(i) The authenticated user must have PROJECT_ADMIN permission for the parent project to be able to create a repository.


There are various options that can be set while creating the repository depending on the content of the input.json file.


Straightforward creation

At a minimum, the input file has to contain the name of the repository:

"name": "My Repository"


Publicly accessible repository

To enable the "Public access" while creating the repository, this is how to define the payload:

"name": "My Repository",
"public": true

Non forkable repository

A non forkable repository ("Allow forks" option unchecked) is created by using this input file:

"name": "My Repository",
"forkable": false


Reference documentation


Is there a full list of repository settings somewhere?

I am trying to change "pull requests"->"Unapprove automatically on new changes" to true, but have no idea where to find this parameter.

Like gabe stepanovich likes this

Is this still working ? Lately I keep getting 

{"type": "error", "error": {"message": "Resource removed", "detail": "This API is no longer supported.\n\nFor information about its removal, please refer to the deprecation notice at:"}}

Hi @bunlongheng

This article is about Bitbucket Server & Data Center while I see you are trying to create a repository in Bitbucket Cloud (

This is the end point that can be used to create a repository in Bitbucket Cloud, in particular you want to use the POST method:



Here is the link to the related documentation:


I am following this process to create a repo in BB Data Center 7.7.1.   When I use curl I get a 404 Error.

My command is:

curl --user <user>:<password> -H "Content-Type: application/json" --data @input.json -X POST<clientCompany>/rest/api/1.0/projects/<projectKey>/repos

input.json only contains the name line in the format above

Error message is: 

"null for uri:<clientCompany>.com/rest/api/1.0/projects/<MyExistingProjectKey>/repos"



Log in or Sign up to comment

Atlassian Community Events