Get Release Bundle Version Promotion Status

JFrog REST APIs

ft:sourceType
Paligo

Description: Returns the current status of the specified Release Bundle 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}

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": [
        {
            "source": "System",
            "text": "Target artifact already exists: commons-qa-generic-local/commons/release-notes-1.0.0.txt",
            "created": "2023-05-19T06:47:56.518Z"
        }
    ]
}

The response includes the following information:

Property

Description

status

Status of the promotion: PROCESSING, 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)