Skip to main content

instance

Fetch a single instance by its ID. Returns null with a NOT_FOUND error if the instance does not exist.

instance(
  organizationId: ID!
  id: ID!
): Instance

Arguments​

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

Your organization's unique identifier.

instance.id ● ID! non-null scalar {#id}​

The instance ID to look up.

Type​

Instance object​

A deployed piece of infrastructure in an environment.

An instance is the runtime representation of a component. When you add a "database" component to your blueprint and deploy it to the staging environment, Massdriver creates an instance that tracks the database's configuration, deployment state, costs, and produced resources.

Lifecycle: Instances progress through a well-defined set of states:

Version resolution: Each instance has a version constraint (e.g., ~1.0) and a releaseStrategy (stable or development). Together these determine the resolvedVersion that will be used on the next deployment. Compare resolvedVersion with deployedVersion to see if a redeployment is needed, or check availableUpgrade for newer matching releases.