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:

Projects

Bitbucket Cloud projects make it easier for teams to focus on a goal, product, or process by organizing their repositories.

List a projects for a team

Deprecated

GET /2.0/teams/{username}/projects/

This endpoint has been deprecated and will stop functioning on August 25th, 2021. You should use the workspace projects endpoint instead. For more information, see the announcement.

OAuth scopes required
project

Request

Path parameters
username Required

string

This can either be the username or the UUID of the account, surrounded by curly-braces, for example: {account UUID}. An account is either a team or user.

Example

1
2
3
4
curl --request GET \
  --url 'https://api.bitbucket.org/2.0/teams/{username}/projects/' \
  --header 'Authorization: Bearer <access_token>' \
  --header 'Accept: application/json'

Responses

A paginated list of projects that belong to the specified team.

Content typeValue
application/json

Paginated Projects

Create a project for a team

Deprecated

POST /2.0/teams/{username}/projects/

Creates a new project.

This endpoint has been deprecated and will stop functioning on August 25th, 2021. You should use the workspace projects endpoint instead. For more information, see the announcement.

Note that the avatar has to be embedded as either a data-url or a URL to an external image as shown in the examples below:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
$ body=$(cat << EOF
{
    "name": "Mars Project",
    "key": "MARS",
    "description": "Software for colonizing mars.",
    "links": {
        "avatar": {
            "href": "data:image/gif;base64,R0lGODlhEAAQAMQAAORHHOVSKudfOulrSOp3WOyDZu6QdvCchPGolfO0o/..."
        }
    },
    "is_private": false
}
EOF
)
$ curl -H "Content-Type: application/json" \
       -X POST \
       -d "$body" \
       https://api.bitbucket.org/2.0/teams/teams-in-space/projects/ | jq .
{
  // Serialized project document
}

or even:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
$ body=$(cat << EOF
{
    "name": "Mars Project",
    "key": "MARS",
    "description": "Software for colonizing mars.",
    "links": {
        "avatar": {
            "href": "http://i.imgur.com/72tRx4w.gif"
        }
    },
    "is_private": false
}
EOF
)
$ curl -H "Content-Type: application/json" \
       -X POST \
       -d "$body" \
       https://api.bitbucket.org/2.0/teams/teams-in-space/projects/ | jq .
{
  // Serialized project document
}
OAuth scopes required
project:write

Request