Get Release Bundle v2 Version Promotion Details

JFrog REST APIs

Products
JFrog Xray
Content Type
REST API
ft:sourceType
Paligo

Description: Returns the specification of the specified Release Bundle v2 version promotion. The specification file contains a snapshot of the items in the promotion.

Since: 7.63.2

Security: Requires Read permissions to the target Release Bundle path.

Usage:GET  /lifecycle/api/v2/promotion/records/{name}/{version}/{created}

Query Parameters (optional): repository_key, project. See Common Optional Query Parameters.

Sample Response:

{
    "environment": "QA",
    "created_by": "admin",
    "created": "2023-05-19T06:21:44.916Z",
    "created_millis": 1684477304916,
    "artifacts": [
        {
            "path": "commons-qa-maven-local/org/apache/tomcat/commons/1.0.0/commons-1.0.0.jar",
            "checksum": "0d2053f76605e0734f5251a78c5dade5ee81b0f3730b3f603aedb90bc58033fb",
            "package_type": "maven",
            "package_name": "commons",
            "package_version": "1.0.0"
        },
        {
            "path": "commons-qa-generic-local/commons/release-notes-1.0.0.txt",
            "checksum": "f87e4c72e60300b451739d545afc0251a6e2f4bd1beaa1902ba739455897ecb8",
            "package_type": "generic"
        }
    ]
}

The response includes the following information:

Property

Description

environment

Name of the target environment for the promotion.

created_by

The user who created the Release Bundle.

created

The timestamp when the Release Bundle was created (ISO 8601 standard).

created_millis

The timestamp when the Release Bundle was created (in milliseconds).

path

The path of a Release Bundle item relative to its contents directory.

checksum

The SHA-256 checksum of the source artifact.

package_type

The package type of the source repository associated with the artifact.

package_name

The name of the package associated with the artifact.

package_version

The version of the package associated with the artifact.

Status Codes:

Code

Description

200

Fetched

401

Bad Credentials

403

Permission Denied

404

Not Found (Release Bundle version/promotion)