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 artifactory/repo-key/path/to/artifact.ext
Headers:
Note
You must include at least one of the optional headers.
X-Checksum-Deploy: true(Required)X-Checksum-Sha1: [sha1Value](Optional)X-Checksum-Sha256: [sha256Value](Optional)X-Checksum: [checksum_value](Required)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"
}