Roll Back Release Bundle v2 Version Promotion

post

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

Removes the latest promotion of a Release Bundle v2 version and restores the version to its previous environment, including the properties and evidence that were present when the version was first created.

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

from_environment

string

required

The name of the current environment in which the Release Bundle version is located. The rollback is executed from this environment.

async

boolean

Defaults to true

Determines whether the operation should be asynchronous (true) or synchronous (false). The default value is true.

project

string

Optional project key associated with the promotion

Body Params

Optional details for the rollback promotion, such as a overwrite_strategy. If not provided, a default empty request is used.

Optional parameters for the rollback promotion operation.

overwrite_strategy

string

enum

Defaults to skip

Specifies the strategy for overwriting artifacts during the rollback. It would overwrite a file that is not part of the release bundle. skip - (default) The overwrite will be skipped. all - the rollback will overwrite the artifact regardless it's tag. latest - the rollback will overwrite the artifact only if it has tag latest.

Allowed:

Responses

Language

Credentials

Bearer

JWT

URL

Loading…

Response

Choose an example:

application/json

200Submitted (Async) - The rollback request was submitted successfully.

201Rolled Back (Sync) - The promotion was rolled back successfully.

401Bad Credentials - Authentication failed.

403Permission Denied - The user does not have the necessary permissions.