Get Release Bundle v2 Versions by Artifact

Description: Returns a list of Release Bundle v2 versions that contain the specified artifact.

Since: 7.107.1

Security: Requires Read permissions to Release Bundle paths. Forbidden Release Bundles are excluded from the results.

Usage: GET /lifecycle/api/v2/release_bundle/search-by-artifact?{artifact_path}&{sha256}

Query Parameters (optional):

Field	Type	Description
`artifact_path`	string	The complete path of the artifact to search for. Important The request must contain either the `artifact_path`, the `sha256`, or both.
`sha256`	string	Filters by the SHA-256 checksum of the artifact. Important The request must contain either the `artifact_path`, the `sha256`, or both.
`release_bundle_name`	string	Filters by the name of the Release Bundle.
`project`	string	[optional] Defines the project associated with the Release Bundles. If this parameter is not specified, the default global project is assumed.Projects
`origin`	string	Defines where to search for the artifact: `source`: Searches the Release Bundle versions that have been created on this device. `target`: Searches the Release Bundle versions that have been received by this device when acting as a destination target. For example, this option enables you to search for Release Bundle versions received by an Edge node. If this parameter is not specified, both source and target Release Bundle versions are searched.
`order_by`	string	[optional] Defines the criterion by which to order the returned records: `release_bundle_name, release_bundle_version` The default is `release_bundle_name`.
`order_asc {true\|false}`	boolean	[optional] Defines whether to list the Release Bundle versions in ascending (true) or descending (false) order. The default value is `true`.
`offset`	integer	Sets the number of records to skip before returning the query response. Used for pagination purposes.
`limit`	integer	Sets the maximum number of versions to return at one time. Used for pagination purposes. If not set, the default is `1000`.

Sample Request (sha256 defined):

curl  http://localhost:8082/lifecycle/api/v2/release_bundle/search-by-artifact?sha256=ddf2f7b01600275ab94084db143d4f14b9d73f224b0f35a8f93d378138c60ff6&origin=target --header 'Authorization: Bearer ***********'

Sample Request (artifact_path defined):

curl --location 'http://{artifactory_url}/lifecycle/api/v2/release_bundle/search-by-artifact?artifact_path=commons-1.0.0.txt' \
--header 'Authorization: Bearer ***********'

Sample Response:

{
    "release_bundles": [
        {
            "release_bundle_name": "A",
            "release_bundle_version": "2",
            "origin": "source",
            "project_key": "default",
            "status": "COMPLETED",
            "created_by": "admin",
            "created": "2025-08-19T07:58:12.765Z",
            "release_status": "PRE_RELEASE"
        },
        {
            "release_bundle_name": "A",
            "release_bundle_version": "1",
            "origin": "source",
            "project_key": "default",
            "status": "COMPLETED",
            "created_by": "admin",
            "created": "2025-08-18T08:59:14.775Z",
            "release_status": "RELEASED",
            "current_stage": "PROD",
            "tag": "Beta"
        }
    ]
}

The response includes the following information:

Property	Description
`release_bundle_name`	The Release Bundle name.
`release_bundle_version`	The Release Bundle version.
`origin`	The origin of the Release Bundle version: `source`: Release Bundle versions that have been created on this device. `target`: Release Bundle versions that have been received by this device when acting as a destination target (for example, and Edge node).
`project_key` `source_project_key`	The project associated with the Release Bundle. When the origin is `target`, the API returns the project key associated with the Release Bundle version at its source.
`status`	Status of the Release Bundle: STARTED, FAILED, COMPLETED, DELETING
`created_by`	The name of the user who created the Release Bundle. Note Names longer than 64 characters will appear truncated.
`created`	Timestamp of when the new version was created (ISO 8601 standard).
`release_status`	Filters by the release status of the Release Bundle version: `released`: Versions that have been released to PROD. `pre_release`: Versions at stages prior to PROD. `trusted_release`: Versions that were released to PROD after a successful evaluation at the PROD release gate.
`current_stage`	The most recent stage (e.g. QA, Staging) to which the version was promoted successfully. This value will be empty if the version has yet to be promoted.
`tag`	The tag assigned to the version to help identify and group it. It typically represents the branch (for example, `latest`, `stable`, `beta`, etc.).

Note

The response is limited to a maximum of 1000 records.

Status Codes:

Code	Description
200	Fetched
400	Bad Request (no criteria specified)
403	Permission Denied

Note

This API returns 200 with an empty body, if:

The artifact isn't a part of any Release Bundle v2 version.
The user does not have permission to see the relevant Release Bundle v2 version.

{
    "release_bundles": []
}

Important

Important

Note

Note

Note