Get Release Bundle v2 Version (GraphQL)

Description: Returns the requested data for the Release Bundle v2 version defined by the One Model GraphQL query.

Important

When operating in a Self-Hosted environment, you must enable the Evidence service in the system.yamlArtifactory System YAML file as a prerequisite to using this endpoint. Add the following:

evidence:
  enabled: true

Since: 7.111.4

Security: Requires a valid token; requires Read permissions for the specified Release Bundle

Usage: POST /onemodel/api/v1/graphql

Tip

To jump directly to common use cases & examples, click here.

Query a Release Bundle Version

Use the getVersion query to fetch a specific Release Bundle version. This is the primary entry point for all Release Bundle version data.

getVersion

Fetches a single Release Bundle version identified by its name, version, and location (repository or project).

query {
  releaseBundleVersion {
    getVersion(name: "my-release-bundle", version: "1.0.0") {
      # Fields to retrieve
      createdBy
      createdAt
    }
  }
}

Field	Required/Optional	Type	Description
`name`	required	string	The name of the Release Bundle.
`version`	required	string	The Release Bundle version.
`repositoryKey`	optional	string	The repository key where the Release Bundle is stored. The default is `release-bundles-v2`.
`projectKey`	optional	string	The project key associated with the Release Bundle. If used without repositoryKey, it resolves to the project's default Release Bundle repository (`[project-key]-release-bundles-v2`).

Repository Selection Logic

This API uses a specific order of preference to determine which repository to query:

repositoryKey is provided: The query targets the specified repository directly. The projectKey is ignored, if provided.
projectKey is provided alone: The query targets the default Release Bundle repository within the specified project.
Neither is provided: The query targets the default global repository, release-bundles-v2.

ReleaseBundleVersion Type

This type represents a specific Release Bundle version and contains all its associated data.

Field	Type	Description
`createdBy`	string	The user who created the Release Bundle version.
`createdAt`	date	The timestamp of when the Release Bundle version was created.
`artifactsConnection`	ReleaseBundleVersionArtifact	Use this connection to retrieve a paginated list of artifacts included in the Release Bundle version. You can filter the results.
`evidenceConnection`	EvidenceConnection	Use this connection to retrieve a paginated list of evidence associated with the Release Bundle version. You can filter the results based on certain criteria: `hasEvidence`: When set to `true`, returns only those artifacts with associated evidence. Set to `false` to return all artifacts. For more information about evidence, see Search Evidence.
`fromBuilds`	array:ReleaseBundleVersionBuild	A list of source builds used to create the Release Bundle version.

Note

Fields such as ReleaseBundleVersionArtifact and EvidenceConnection use a cursor-based pagination model, which is a standard GraphQL pattern for handling large data sets efficiently.

For more information, see One Model GraphQL Common Patterns and Conventions.

Detailed Object Types

This type represents a single artifact within the Release Bundle version.

Field	Type	Description
`path`	string	The artifact path inside the Release Bundle.
`name`	string	The artifact name.
`sha256`	SHA-256	The SHA256 of the artifact.
`sourceRepositoryPath`	string	The source path from which the artifact was added to the Release Bundle.
`packageType`	string	The package type of the package to which the artifact belongs.
`packageName`	string	The name of the package to which the artifact belongs.
`packageVersion`	string	The version of the package to which the artifact belongs.
`size`	integer	The artifact size.
`properties`	array:ReleaseBundleVersionArtifactProperty	User-defined properties defined for the artifact.
`evidenceConnection`	EvidenceConnection	Information related to the evidence associated with each artifact. For more details about evidence, see Search Evidence.

This type represents a build used as a source for the Release Bundle version.

Field	Type	Description
`name`	string	The name of the build-info in Artifactory.
`number`	string	The build number.
`startedAt`	date	The start time of the build.
`repositoryKey`	string	The repository that contains the build-info.
`evidenceConnection`	EvidenceConnection	A pagination list of evidence for the specific build. For more details about evidence, see Search Evidence.

This type represents the key-value pairs defined as properties of the artifact.

Field	Type	Description
`key`	string	The property key.
`values`	array:string	A list of values for the property.

Status Codes

Code	Message	Description
200	Ok	The request was successful.
401	Bad Credentials	The request failed because the provided authentication token is invalid or expired.
403	Permission Denied	The request failed because the authenticated user does not have the required Read permissions for the subject repository.