Get Release Bundle v2 Version Promotion Status

JFrog REST APIs

Products
JFrog Xray
Content Type
REST API
ft:sourceType
Paligo

Description: Returns the current status of the specified Release Bundle v2 version promotion.

Since: 7.63.2

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

Usage:GET  /lifecycle/api/v2/promotion/statuses/{name}/{version}/{created_millis}

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

Sample Response (without errors):

{
    "status": "COMPLETED"
}

Sample Response (with errors, sample payload):

{
    "status": "FAILED",
    "messages": [
        {
            "text": "Target artifact already exists: commons-qa-generic-local/commons/release-notes-1.0.0.txt"
        }
    ]
}

The response includes the following information:

Property

Description

status

Status of the promotion: STARTED, FAILED, COMPLETED, DELETING

messages

Error messages generated by a failed promotion.

Status Codes:

Code

Description

200

Fetched

401

Bad Credentials

403

Permission Denied

404

Not Found (Release Bundle version/promotion)