Sign in

v5

latestOpenAPI 3.1.0raw.githubusercontent.com2026-06-167122208.0 KB
packages

promote

Promote a package.

This API is similar to a move operation. Once this API call completes successfull, the package being promoted will only exist in the destination.

The dependencies array for Debian packages will list dependencies for the following contexts: depends, recommends, suggests, enhances, pre-depends

The dependencies array for Debian Source packages (DSC) will list dependencies for the following contexts: build-depends and build-depends-indep

The dependencies array for Node.js packages will list dependencies for the following contexts: dependencies, devDependencies, optionalDependencies, bundleDependencies, and peerDependencies.

The dependencies array for Node.js packages will list dependencies for the following contexts: dependencies, devDependencies, optionalDependencies, bundleDependencies, and peerDependencies.

Example request:

curl -X POST                                \
     -F "destination=julio/testrepo"        \
     "https://packagecloud.io/api/v1/repos/user/example-repo/el/7/jake-1.0-3.el6.x86_64.rpm/promote.json"
post/api/v1/repos/{user_id}/{repo}/{distro}/{version}/{package}/promote.json

Path parameters

user_idstring required

The user this repo belongs to.

repostring required

The name of the repository.

distrostring required

The name of the distribution the package is in. (i.e. ubuntu)

versionstring required

The version name of the distribution the package is in. (i.e. precise)

packagestring required

The full name of the package.

Query parameters

scopestring

The scope of the Node.JS package to promote. Only required if the package to promote is scoped. Include the escaped '@' (i.e. ?scope=%40example).

Response

PackageDetails A JSON object representing the package.

namestring required

The name of the package.

distro_versionstring required

The distro_version for the package.

architecturestring nullable required

The architecture of the package.

repositorystring required

The name of the repository for the package.

sizestring required

The size (in bytes) of the package. Returned as a String for JavaScript support.

summarystring nullable required

The summary of the package (if available).

filenamestring required

The filename of the package.

descriptionstring nullable required

The description of the package (if available).

md5sumstring nullable required

The MD5 checksum for the package (if available).

sha1sumstring nullable required

The SHA1 checksum for the package (if available).

sha256sumstring nullable required

The SHA256 checksum for the package (if available).

sha512sumstring nullable required

The SHA512 checksum for the package (if available).

privateboolean required

Whether or not the package is in a private repository.

uploader_namestring required

The name of the uploader for the package.

created_atstring required

When the package was uploaded.

licensesstring[] required

Array of licenses for this package (if available).

versionstring required

The version of the package.

releasestring nullable required

The release of the package (if available).

epochinteger nullable required

The epoch of the package (if available).

indexedboolean required

Whether or not this package has been indexed.

scopestring nullable required

The scope of the package (if available).

repository_html_urlstring required

The HTML url of the repository.

versions_urlstring required

The API url of other versions of this package.

promote_urlstring required

The API url that can be used to promote this package.

total_downloads_countinteger required

The number of times this package has been downloaded.

download_urlstring required

The url to download this package.

package_html_urlstring required

The HTML url for this package.

downloads_detail_urlstring required

The url to get access log details for package downloads.

downloads_series_urlstring required

The url to get time series data for package downloads.

downloads_count_urlstring required

The url to get the total number of package downloads.

destroy_urlstring required

The url for the HTTP DELETE request to destroy this package.

self_urlstring required

The API url for this response.

repository_urlstring required
package_urlstring required

Example response

{
  "name": "jake",
  "distro_version": "fedora/22",
  "architecture": "x86_64",
  "repository": "test_repo",
  "size": "3712",
  "summary": "jake douglas is a very nice young man.",
  "filename": "jake-1.0-1.el6.x86_64.rpm",
  "description": "as it so happens, jake douglas is a very nice young man.",
  "dependencies": [
    {
      "context": "requires",
      "dependencies": [
        "libc.so.6(GLIBC_2.2.5)(64bit)",
        "rtld(GNU_HASH)"
      ]
    }
  ],
  "md5sum": "5abe922fc4bbf5bbdac9b85173371892",
  "sha1sum": "062fd41ecf96587309ec9a3ae2035cc44c348b8f",
  "sha256sum": "070da5370a96ba3ae679e7d02d7de6309e4d159340d9f3b555d6d5b4b7cf260a",
  "sha512sum": "406fa288d5dfff194ec2b119b798c4658375a5d07b34f2d6350885cdf6b620f3fdeee45427fef8bcd37e6624049fba0c633b5b4030b79bf96028db6b4f01de87",
  "private": false,
  "uploader_name": "test_user",
  "created_at": "2017-03-13T02:49:29.000Z",
  "licenses": [
    "GPL"
  ],
  "version": "1.0",
  "release": "1.el6",
  "epoch": 0,
  "indexed": false,
  "scope": null,
  "repository_url": "/api/v1/repos/test_user/test_repo",
  "repository_html_url": "/test_user/test_repo",
  "package_url": "/api/v1/repos/test_user/test_repo/package/rpm/fedora/22/jake/x86_64/1.0/1.el6.json",
  "versions_url": "/api/v1/repos/test_user/test_repo/package/rpm/fedora/22/jake/x86_64/versions.json",
  "promote_url": "/api/v1/repos/test_user/test_repo/fedora/22/jake-1.0-1.el6.x86_64.rpm/promote.json",
  "total_downloads_count": 0,
  "download_url": "https://packagecloud.io/test_user/test_repo/packages/fedora/22/jake-1.0-1.el6.x86_64.rpm/download",
  "package_html_url": "/test_user/test_repo/packages/fedora/22/jake-1.0-1.el6.x86_64.rpm",
  "downloads_detail_url": "/api/v1/repos/test_user/test_repo/package/rpm/fedora/22/jake/x86_64/1.0/1.el6/stats/downloads/detail.json",
  "downloads_series_url": "/api/v1/repos/test_user/test_repo/package/rpm/fedora/22/jake/x86_64/1.0/1.el6/stats/downloads/series/daily.json",
  "downloads_count_url": "/api/v1/repos/test_user/test_repo/package/rpm/fedora/22/jake/x86_64/1.0/1.el6/stats/downloads/count.json",
  "destroy_url": "/api/v1/repos/test_user/test_repo/fedora/22/jake-1.0-1.el6.x86_64.rpm",
  "self_url": "/api/v1/repos/test_user/test_repo/package/rpm/fedora/22/jake/x86_64/1.0/1.el6.json"
}