Create Release Bundle v2 Version

post

https://{jfrog_url}/lifecycle/api/v2/release_bundle

Creates a new Release Bundle v2, uniquely identified by a combination of repository key, name, and version. You can create a Release Bundle version using one or a combination of the following source types AQL, Artifacts, Packages, Builds, or Release Bundles.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

async

boolean

Defaults to true

Whether to create the bundle asynchronously

fail_fast

boolean

Defaults to true

Whether to fail fast on errors

project

string

The project key used to determine the Release Bundles repository. By convention, each project may contain only one Release Bundles system repository with the name -release-bundles-v2. This query parameter may be used instead of repository_key.

repository_key

string

The Release Bundles repository identifier that identifies where a Release Bundle version resides. If this parameter and the project query parameter are not specified, the default value of release-bundles-v2 is assumed.

Body Params

Release bundle creation request containing bundle name, version, source type, and source configurations

release_bundle_name

string

required

Release bundle name. Must begin with a letter, underscore, or digit and consist of letters, underscores, dots, hyphens, or digits.

release_bundle_version

string

required

Release bundle version. Must begin with a letter, underscore, or digit and consist of letters, underscores, dots, hyphens, plus signs, or digits.

skip_docker_manifest_resolution

boolean

Defaults to false

Whether to skip Docker manifest resolution during bundle creation

source_type

string

enum

Type of source for the bundle. Supported values are 'aql' (Artifactory Query Language), 'builds', 'artifacts', 'release_bundles', or 'packages'.

Allowed:

source

object

Single source configuration object. The structure depends on the source_type. For artifacts, it may contain path patterns. For builds, it may contain build name and number. For AQL, it may contain AQL query.

sources

array of objects

Multiple source configurations. Use this when you need to include multiple sources in the bundle. Each source object structure depends on the source_type.

sources

tag

string

length ≤ 128

Optional tag to assign to the release bundle. Must not contain spaces or special characters except hyphens, underscores, and dots.

Responses

200Submitted (async) - The creation request was submitted successfully.

201Created (sync) - The Release Bundle version was created successfully.

400Bad Request - The request body is malformed, a required parameter is missing, or the AQL is invalid.

401Bad Credentials - Authentication failed. A valid token is required.

403Permission Denied - The user does not have write permissions for the target repository.

404Not Found - A specified resource (source artifact, build, package, or repository) could not be found.

409Already Exists - A Release Bundle with the same name and version already exists in the target repository.