Skip to main content

Instance

An instance with its full details and related resources.

type Instance {
id: ID!
name: String!
status: InstanceStatus!
tags: Map!
version: String!
releaseStrategy: ReleaseStrategy!
createdAt: DateTime!
updatedAt: DateTime!
resolvedVersion: String!
deployedVersion: String
availableUpgrade: String
cost: CostSummary!
environment: Environment
bundle: Bundle
resources(
cursor: Cursor
): InstanceResourcesPage
dependencies(
cursor: Cursor
): InstanceDependenciesPage
}

Fields

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

Instance.name ● String! non-null scalar {#name}

Display name

Instance.status ● InstanceStatus! non-null enum {#status}

Current state of the instance

Instance.tags ● Map! non-null scalar {#tags}

Tags assigned directly to this instance

Instance.version ● String! non-null scalar {#version}

Version constraint (e.g., '~1.0' or '1.2.3')

Instance.releaseStrategy ● ReleaseStrategy! non-null enum {#release-strategy}

Whether to use stable or development releases

Instance.createdAt ● DateTime! non-null scalar {#created-at}

When this instance was created (UTC)

Instance.updatedAt ● DateTime! non-null scalar {#updated-at}

When this instance was last modified (UTC)

Instance.resolvedVersion ● String! non-null scalar {#resolved-version}

The actual version resolved from the version constraint, used for the next deployment.

Instance.deployedVersion ● String scalar {#deployed-version}

The version last deployed to infrastructure. May differ from resolvedVersion if not yet deployed.

Instance.availableUpgrade ● String scalar {#available-upgrade}

Newest version available for upgrade, or null if already on the latest matching version.

Instance.cost ● CostSummary! non-null object {#cost}

Cloud provider costs for this instance.

Instance.environment ● Environment object {#environment}

The environment this instance is deployed in.

Instance.bundle ● Bundle object {#bundle}

The bundle version currently deployed.

Instance.resources ● InstanceResourcesPage object {#resources}

Resources produced by this instance (its output artifacts).

Instance.resources.cursor ● Cursor input {#instance-resources-cursor}

Instance.dependencies ● InstanceDependenciesPage object {#dependencies}

Dependencies consumed by this instance (artifacts from other instances wired via connections).

Instance.dependencies.cursor ● Cursor input {#instance-dependencies-cursor}

Returned By

instance query

Member Of

Deployment object