Promote Docker Image

Promotes a Docker image from one repository to another. Supports local and federated repositories. This REST API also supports promoting Helm OCI images. Requires JFrog Container Registry or Artifactory Pro.

Since: 3.7

Security: Requires a privileged user

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

Source repository key

Body Params

Docker promotion request

string
required

The target repository for the move or copy

string
required

The image name to promote

string

An optional docker repository name, if null, will use the same name as 'dockerRepository'

string

An optional tag name to promote, if null - the entire docker repository will be promoted. Available from v4.10.

string

An optional target tag to assign the image after promotion, if null - will use the same tag

boolean
Defaults to false

An optional value to set whether to copy instead of move. Default false

Responses

400

Bad Request - The request body is malformed or a required parameter is missing.

401

Bad Credentials - Authentication failed. A valid token is required.

403

Permission Denied - The user does not have the necessary permissions to perform this action.

404

Not Found - The specified repository or Docker image does not exist.

Language
Credentials
URL
LoadingLoading…
Response
Choose an example:
text/plain