Cloud

Bitbucket Cloud / Reference / REST APIs

Downloads

Access the list of download links associated with the repository.

Operations

GET/repositories/{workspace}/{repo_slug}/downloads POST/repositories/{workspace}/{repo_slug}/downloads GET/repositories/{workspace}/{repo_slug}/downloads/{filename}DEL/repositories/{workspace}/{repo_slug}/downloads/{filename}

GET

List download artifacts

Returns a list of download links associated with the repository.

Scopes

OAuth 2.0 scopes required:

repository

Forge app scopes required:

read:repository:bitbucket

Request

Path parameters

repo_slug

string

Required

workspace

string

Required

Responses

Returns a paginated list of the downloads associated with the repository.

GET/repositories/{workspace}/{repo_slug}/downloads

curl

Node.js

Java

Python

PHP

1
2
3

curl --request GET \
  --url 'https://api.bitbucket.org/2.0/repositories/{workspace}/{repo_slug}/downloads' \
  --header 'Authorization: Bearer <access_token>'

POST

Upload a download artifact

Upload new download artifacts.

To upload files, perform a multipart/form-data POST containing one or more files fields:


1
2
$ echo Hello World > hello.txt
$ curl -s -u evzijst -X POST https://api.bitbucket.org/2.0/repositories/evzijst/git-tests/downloads -F files=@hello.txt

When a file is uploaded with the same name as an existing artifact, then the existing file will be replaced.

OAuth 2.0 scopes required:

repository:write

Request

Path parameters

repo_slug

string

Required

workspace

string

Required

Responses

The artifact was uploaded sucessfully.

POST/repositories/{workspace}/{repo_slug}/downloads

curl

Node.js

Java

Python

PHP

1
2
3

curl --request POST \
  --url 'https://api.bitbucket.org/2.0/repositories/{workspace}/{repo_slug}/downloads' \
  --header 'Authorization: Bearer <access_token>'

GET

Get a download artifact link

Return a redirect to the contents of a download artifact.

This endpoint returns the actual file contents and not the artifact's metadata.


1
2
$ curl -s -L https://api.bitbucket.org/2.0/repositories/evzijst/git-tests/downloads/hello.txt
Hello World

OAuth 2.0 scopes required:

repository

Request

Path parameters

filename

string

Required

repo_slug

string

Required

workspace

string

Required

Responses

Redirects to the url of the specified download artifact.

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

curl

Node.js

Java

Python

PHP

1
2
3

curl --request GET \
  --url 'https://api.bitbucket.org/2.0/repositories/{workspace}/{repo_slug}/downloads/{filename}' \
  --header 'Authorization: Bearer <access_token>'

DEL

Delete a download artifact

Deletes the specified download artifact from the repository.

Scopes

OAuth 2.0 scopes required:

repository:write

Forge app scopes required:

write:repository:bitbucket

Request

Path parameters

filename

string

Required

repo_slug

string

Required

workspace

string

Required

Responses

The specified download artifact was deleted.

DEL/repositories/{workspace}/{repo_slug}/downloads/{filename}

curl

Node.js

Java

Python

PHP

1
2
3

curl --request DELETE \
  --url 'https://api.bitbucket.org/2.0/repositories/{workspace}/{repo_slug}/downloads/{filename}' \
  --header 'Authorization: Bearer <access_token>'