Get Release Bundle v2 Version Promotions

get

https://{jfrog_url}/lifecycle/api/v2/promotion/records/{name}/{version}

Returns the details of all promotions for the specified Release Bundle v2 version. All promotion records are provided regardless of status, including failed attempts.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

❗
RLM Deprecation
As of July 31, 2026, all feature development, patches, and security fixes for Release Lifecycle Management will end, except for critical security fixes. RLM End of Life is currently scheduled for January 31, 2028. For more information, see JFrog Release Lifecycle Management Deprecation - End of Life.

Path Params

name

string

required

^\w[\w\-.]*$

Release bundle name

version

string

required

^\w[\w\-.+]*$

Release bundle version

Query Params

project

string

The project key used to determine the Release Bundles repository

repository_key

string

The Release Bundles repository identifier

include

string

Returns any error messages generated when creating the promotion

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

Sets the maximum number of versions to return at one time. Used for pagination purposes.

filter_by

string

Filters the list of promotions by performing a substring match across the environment, and created_by fields. A promotion is returned if the specified string appears in either of these fields. This is not a field-specific filter; the value is matched as a substring across both fields simultaneously.

order_by

string

enum

Defines the criterion by which to order the list of promotions (created, created_millis, created_by, environment)

Allowed:

order_asc

boolean

Defaults to false

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

Responses

Language

Credentials

Bearer

JWT

URL

Loading…

Response

Choose an example:

application/json

200Fetched - Successfully retrieved promotions

401Bad Credentials - The provided authentication is invalid.

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