--- updatedAt: 2026-09-01T08:41:13.000Z agentTools: siteIndex: https://docs.jfrog.com/llms.txt projectIndex: https://docs.jfrog.com/governance/llms.txt --- # Get Release Bundle v2 Versions by Artifact Returns a list of Release Bundle v2 versions that contain the specified artifact. Supports filtering by bundle name, artifact path, SHA256, and pagination. **Security:** Requires Read permissions to the Release Bundle paths. # OpenAPI definition ```json { "openapi": "3.1.0", "info": { "title": "Release Lifecycle Management API", "description": "API for managing release bundles in JFrog Artifactory - Based on official JFrog REST API documentation", "version": "3.x-SNAPSHOT", "contact": { "name": "JFrog Support", "url": "https://jfrog.com/help", "email": "support@jfrog.com" } }, "servers": [ { "url": "https://{jfrog_url}/lifecycle/api/v2", "description": "JFrog Platform", "variables": { "jfrog_url": { "default": "myserver.jfrog.io", "description": "Your JFrog Platform hostname (e.g., mycompany.jfrog.io)" } } } ], "tags": [ { "name": "Release Bundle V2 Management", "description": "Release bundle management operations" } ], "paths": { "/release_bundle/search-by-artifact": { "get": { "tags": [ "Release Bundle V2 Management" ], "summary": "Get Release Bundle v2 Versions by Artifact", "description": "Returns a list of Release Bundle v2 versions that contain the specified artifact. Supports filtering by bundle name, artifact path, SHA256, and pagination.\n\n**Security:** Requires Read permissions to the Release Bundle paths.", "x-since": "7.63.2", "operationId": "getBundlesByArtifact", "parameters": [ { "name": "release_bundle_name", "in": "query", "description": "Filters by the name of the Release Bundle.", "required": false, "schema": { "type": "string" } }, { "name": "artifact_path", "in": "query", "description": "The complete path of the artifact to search for. The request must contain either the artifact_path, the sha256, or both.", "required": false, "schema": { "type": "string" } }, { "name": "sha256", "in": "query", "description": "Filters by the SHA-256 checksum of the artifact. The request must contain either the artifact_path, the sha256, or both.", "required": false, "schema": { "type": "string" } }, { "name": "project", "in": "query", "description": "Defines the project associated with the Release Bundles. If this parameter is not specified, the default global project is assumed.", "required": false, "schema": { "type": "string" } }, { "name": "origin", "in": "query", "description": "Defines where to search for the artifact. 'source' searches the Release Bundle versions that have been created on this device. 'target' searches the Release Bundle versions that have been received by this device when acting as a destination target. If this parameter is not specified, both source and target Release Bundle versions are searched.", "required": false, "schema": { "type": "string", "enum": [ "both", "source", "target" ], "default": "both" } }, { "name": "offset", "in": "query", "description": "Sets the number of records to skip before returning the query response. Used for pagination purposes.", "required": false, "schema": { "type": "integer", "minimum": 0, "default": 0 } }, { "name": "limit", "in": "query", "description": "Sets the maximum number of versions to return at one time. Used for pagination purposes. If not set, the default is 1000.", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 1000, "default": 1000 } }, { "name": "order_by", "in": "query", "description": "Defines the criterion by which to order the returned records. Options 'release_bundle_name', 'release_bundle_version'. The default is release_bundle_name.", "required": false, "schema": { "type": "string", "enum": [ "release_bundle_name", "release_bundle_version" ] } }, { "name": "order_asc", "in": "query", "description": "Defines whether to list the Release Bundle versions in ascending (true) or descending (false) order. The default value is true.", "required": false, "schema": { "type": "boolean", "default": true } }, { "name": "sort", "in": "query", "description": "Sort criteria", "required": false, "schema": { "type": "string", "default": "release_bundle_name:asc,release_bundle_version:desc" } } ], "responses": { "200": { "description": "OK - Successfully retrieved bundles containing the artifact", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetBundlesByArtifactResponse" }, "examples": { "bundles_by_artifact": { "summary": "Bundles containing an artifact", "value": { "release_bundles": [ { "release_bundle_name": "my-bundle", "release_bundle_version": "1.0.0", "origin": "source", "project_key": "default", "status": "COMPLETED", "created_by": "admin", "created": "2025-04-29T14:17:21.587Z" } ], "total": 1, "limit": 1000, "offset": 0 } } } } } }, "400": { "description": "Bad Request - Invalid query parameters.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Bad Credentials - The provided authentication is invalid.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "403": { "description": "Permission Denied - The user does not have the necessary permissions to perform this action.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal server error", "content": {} } } } } }, "components": { "schemas": { "ErrorResponse": { "type": "object", "description": "Standard error body for non-2xx responses (400, 401, 403, 404, 500). Matches Artifactory-style error format.", "properties": { "errors": { "type": "array", "items": { "$ref": "#/components/schemas/ErrorItem" }, "description": "List of error entries" } } }, "ErrorItem": { "type": "object", "description": "A single error entry in an error response.", "properties": { "status": { "type": "integer", "description": "HTTP status code (e.g. 400, 401, 403, 404, 500)" }, "message": { "type": "string", "description": "Human-readable error message" } } }, "GetBundlesByArtifactResponse": { "type": "object", "properties": { "release_bundles": { "type": "array", "items": { "$ref": "#/components/schemas/BundleByArtifactSummary" }, "description": "List of bundles containing the artifact" }, "total": { "type": "integer", "description": "Total number of bundles" }, "limit": { "type": "integer", "description": "Maximum number of results per page" }, "offset": { "type": "integer", "description": "Pagination offset" } } }, "BundleByArtifactSummary": { "type": "object", "description": "Summary of a bundle that contains a specific artifact", "properties": { "release_bundle_name": { "type": "string", "description": "Name of the release bundle" }, "release_bundle_version": { "type": "string", "description": "Version of the release bundle" }, "origin": { "type": "string", "description": "Origin of the bundle (source or target)" }, "project_key": { "type": "string", "description": "Project key (only if origin is source)" }, "source_project_key": { "type": "string", "description": "Source project key (only if origin is target)" }, "status": { "type": "string", "description": "Status of the bundle version" }, "created_by": { "type": "string", "description": "User who created the bundle" }, "created": { "type": "string", "description": "Creation timestamp" }, "tag": { "type": "string", "description": "Tag assigned to the bundle" }, "release_status": { "type": "string", "description": "Release status" }, "current_stage": { "type": "string", "description": "Current stage" } } } }, "securitySchemes": { "bearerAuth": { "type": "http", "scheme": "bearer", "bearerFormat": "JWT", "description": "JWT token authentication" } } }, "security": [ { "bearerAuth": [] } ] } ```