Get Application Version Promotion Details

Description: Returns the details of the specified application version promotion.

Security: Requires Read permissions to the target application version path

Usage: GET /apptrust/api/v1/applications/{application_key}/versions/{version}/promotions/{created_millis}

Path Parameters:

Parameter	Type	Description
`application_key`	string	The unique application key.
`version`	string	The application version.
`created_millis`	integer	The timestamp when the application version promotion was initiated (in milliseconds).

Response Body:

Property	Type	Description
`target_stage`	string	The stage to which the application version was promoted.
`created_by`	string	The user who created the application version.
`created`	string	The timestamp when the application version promotion was initiated (ISO 8601 standard).
`created_millis`	integer	The timestamp when the application version promotion was initiated (in milliseconds).
`artifacts`	array	The artifacts included in the promotion.
`artifacts.path`	string	The path of an application version item relative to the path of the artifact in Artifactory, including the repository key.
`artifacts.checksum`	string	The SHA-256 checksum of the source artifact.
`artifacts.package_type`	string	The package type.
`artifacts.package_name`	string	The package name.
`artifacts.package_version`	string	The package version.

Sample Request:

GET 'https://{host}.jfrog.io/apptrust/api/v1/applications/catalina-app/versions/1.0.0/promotions/1684477304916 
Content-Type: application/json
Authorization: ••••••

Sample Response:

{
    "target_stage": "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": "org.apache.tomcat:commons",
            "package_version": "1.0.0"
        },
        {
            "path": "commons-qa-generic-local/commons/release-notes-1.0.0.txt",
            "checksum": "f87e4c72e60300b451739d545afc0251a6e2f4bd1beaa1902ba739455897ecb8",
            "package_type": "generic"
        }
    ]
}

Status Codes:

Code	Description
200	Fetched
401	Bad Credentials
403	Permission Denied
404	Not Found (application, application version, or promotion)