Get Release Bundle v2 Versions by Artifact

get

https://{jfrog_url}/lifecycle/api/v2/release_bundle/search-by-artifact

Returns a list of Release Bundle v2 versions that contain the specified artifact. Supports filtering by bundle name, artifact path, SHA256, and pagination.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

release_bundle_name

string

Filters by the name of the Release Bundle.

artifact_path

string

The complete path of the artifact to search for. The request must contain either the artifact_path, the sha256, or both.

sha256

string

Filters by the SHA-256 checksum of the artifact. The request must contain either the artifact_path, the sha256, or both.

project

string

Defines the project associated with the Release Bundles. If this parameter is not specified, the default global project is assumed.

origin

string

enum

Defaults to both

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. If this parameter is not specified, both source and target Release Bundle versions are searched.

Allowed:

offset

integer

≥ 0

Defaults to 0

Sets the number of records to skip before returning the query response. Used for pagination purposes.

limit

integer

1 to 1000

Defaults to 1000

Sets the maximum number of versions to return at one time. Used for pagination purposes. If not set, the default is 1000.

order_by

string

enum

Defines the criterion by which to order the returned records. Options 'release_bundle_name', 'release_bundle_version'. The default is release_bundle_name.

Allowed:

order_asc

boolean

Defaults to true

Defines whether to list the Release Bundle versions in ascending (true) or descending (false) order. The default value is true.

sort

string

Defaults to release_bundle_name:asc,release_bundle_version:desc

Sort criteria

Responses

500

Internal server error

200OK - Successfully retrieved bundles containing the artifact

400Bad Request - Invalid query parameters.

401Bad Credentials - The provided authentication is invalid.

403Permission Denied - The user does not have the necessary permissions to perform this action.