The following examples show how to retrieve a list of Release Bundle v2 versions that meet your defined criteria:
Example 1: Basic Request and Response
This is a basic request to get the latest versions of the "my-app" Release Bundle. The response contains a list of versions.
Request:
curl -u my-user -X GET "http://jfrog-platform-url/lifecycle/api/v2/release_bundle/records/my-app"
Response:
{
"data": [
{
"release_bundle_name": "my-app",
"release_bundle_version": "1.0.1",
"status": "COMPLETED",
"release_status": "released",
"current_environment": "PROD",
"created_by": "automation-user",
"created": "2023-10-26T12:00:00Z",
"bundle_tag": "stable"
},
{
"release_bundle_name": "my-app",
"release_bundle_version": "1.0.0",
"status": "COMPLETED",
"release_status": "pre_release",
"current_environment": "staging",
"created_by": "jane.doe",
"created": "2023-09-15T10:30:00Z",
"bundle_tag": "initial-release"
}
],
"total": 2,
"limit": 250,
"offset": 0
}
Example 2: Filtering by Status and Including Messages
This example retrieves only the FAILED versions and includes the messages object to see the creation errors.
Request:
curl -u my-user -X GET "http://jfrog-platform-url/lifecycle/api/v2/release_bundle/records/my-app?filter_by=status:FAILED&include=messages"
Response:
{
"data": [
{
"release_bundle_name": "my-app",
"release_bundle_version": "0.9.0-beta",
"status": "FAILED",
"release_status": "",
"current_environment": "",
"created_by": "dev-script",
"created": "2023-09-10T18:45:00Z",
"bundle_tag": null,
"messages": [
{
"text": "Invalid AQL query for Release Bundle creation"
}
],
"permissions": {
"promote": false,
"distribute": false,
"delete": true
}
}
],
"total": 1
"limit": 250,
"offset": 0
}
Example 3: Filtering by Creator and Tag
This example retrieves versions created by jane.doe that also have the initial-release tag. Permissions are included.
Request:
curl -u my-user -X GET "http://jfrog-platform-url/lifecycle/api/v2/release_bundle/records/my-app?filter_by=created_by:jane.doe;tag:initial-release&include=permissions"
Response:
{
"data": [
{
"release_bundle_name": "my-app",
"release_bundle_version": "1.0.0",
"status": "COMPLETED",
"release_status": "pre_release",
"current_environment": "staging",
"created_by": "jane.doe",
"created": "2023-09-15T10:30:00Z",
"bundle_tag": "initial-release",
"permissions": {
"promote": true,
"distribute": true,
"delete": true
}
}
],
"total": 1
"limit": 250,
"offset": 0
}
Example 4: Filtering by a Specific Version
This example retrieves the record for a single, specific version ("1.0.1").
Request:
curl -u my-user -X GET "http://jfrog-platform-url/lifecycle/api/v2/release_bundle/records/my-app?filter_by=release_bundle_version:1.0.1"
Response:
{
"data": [
{
"release_bundle_name": "my-app",
"release_bundle_version": "1.0.1",
"status": "COMPLETED",
"release_status": "released",
"current_environment": "PROD",
"created_by": "automation-user",
"created": "2023-10-26T12:00:00Z",
"bundle_tag": "stable"
}
}
],
"total": 1
"limit": 250,
"offset": 0
}