bundle

Fetch a single bundle by its composite identifier.

The id accepts a name@version string where the version portion can be an exact semver, a release channel, or omitted entirely:

Input	Resolves to
aws-aurora-postgres@1.2.3	Exact version 1.2.3
aws-aurora-postgres@~1.2	Latest patch in 1.2.x
aws-aurora-postgres@~1	Latest minor in 1.x.x
aws-aurora-postgres@latest	Newest stable release
aws-aurora-postgres@latest+dev	Newest release including dev builds
aws-aurora-postgres	Shorthand for latest (falls back to latest+dev if no stable exists)

Returns null with a NOT_FOUND error if no matching version exists.

query {
  bundle(organizationId: "your-org-id", id: "aws-aurora-postgres@~1") {
    id
    version
    dependencies { name required resourceType { id name } }
    resources { name required resourceType { id name } }
  }
}

bundle(
  organizationId: ID!
  id: BundleId!
): Bundle

Arguments

bundle.organizationId ● ID! non-null scalar {#organization-id}

Your organization's unique identifier.

bundle.id ● BundleId! non-null scalar {#id}

Bundle identifier in name@version format. The version can be an exact semver, a release channel, or omitted to resolve latest.

Type

Bundle object

A versioned infrastructure-as-code package.

A bundle is a single published version of an IaC package in your organization's catalog. Each bundle belongs to an OCI repository and is identified by a composite name@version string (e.g., aws-aurora-postgres@1.2.3).

Bundles declare dependencies (inputs they require from other bundles) and resources (outputs they produce). These declarations drive the connection system on the Massdriver canvas -- when you add a component to a blueprint, the platform knows which other components can satisfy its dependencies.