Deploy Artifact by Checksum

Description: Deploy an artifact to the specified destination by checking if the artifact content already exists in Artifactory.

If Artifactory already contains a user-readable artifact with the same checksum, the artifact content is copied to the new location and returns a response without requiring content transfer.

Otherwise, a 404 error is returned to indicate that content upload is expected to deploy the artifact.

If the X-Checksum-Deploy header is set to false, the artifact will be uploaded successfully with a 201 response, even if it didn't exist before, and submitted checksums will have the status Uploaded: Identical.

Notes: You can also attach properties when deploying artifacts.

Security: Requires a user with Deploy permissions (can be anonymous)

Usage: PUT /repo-key/path/to/artifact.ext

Headers:

X-Checksum-Deploy: true
X-Checksum-Sha1: [sha1Value]
X-Checksum-Sha256: [sha256Value]
X-Checksum: [checksum_value] (type is resolved by length)

Produces: application/json (application/vnd.org.jfrog.artifactory.storage.ItemCreated+json)

Since: 2.5.1

Sample Output:

curl -X PUT -u [username]:[password] [artifactory_url]/artifactory/[repo_name]/[artifact_path] --data-binary @[path_to_local_file] -H "X-Checksum-Deploy: true" -H "X-Checksum-Sha256: [sha256Value]" -H "X-Checksum-Sha1: [sha1Value]"
{
"uri": "http://localhost:8081/artifactory/libs-release-local/my/jar/1.0/jar-1.0.jar",
"downloadUri": "http://localhost:8081/artifactory/libs-release-local/my/jar/1.0/jar-1.0.jar",
    "repo": "generic-local",
    "path": "/MB-text-file.txt",
    "created": "2025-04-06T09:13:04.174Z",
    "createdBy": "userY",
    "downloadUri": "https://productdemo.jfrog.io/artifactory/generic-local/MB-text-file.txt",
    "mimeType": "text/plain",
    "size": "452",
    "checksums": {
        "sha1": "b17578e9b3e2574eac9c81196a2d294454cc06f3",
        "md5": "73993b365a652ec99629ef4bed9715a3",
        "sha256": "8073c43a6539402707fafdabd116dd7547e00d1a5582706bd6ae7e83f4113486"
    },
    "originalChecksums": {
        "sha1": "b17578e9b3e2574eac9c81196a2d294454cc06f3",
        "md5": "73993b365a652ec99629ef4bed9715a3",
        "sha256": "8073c43a6539402707fafdabd116dd7547e00d1a5582706bd6ae7e83f4113486"
    },
    "uri": "https://productdemo.jfrog.io/artifactory/generic-local-mjb/MB-text-file.txt"
}