Get Release Bundle v2 Promotions

get

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

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

Security: Requires Read permissions to the target Release Bundle path.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

name

string

required

length ≥ 1

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

Release bundle name

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

Defines a filter for the list of promotions. You can filter according to bundle_version, promotion_environment, promotion_created_by

order_by

string

enum

Defines the criterion by which to order the list of promotions (created, created_millis, created_by, release_bundle_version, 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

Click Try It! to start a request and see the response here! Or 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.

404Not Found - The specified resource was not found.