resourceTypeDependents

List the instances in an environment that depend on a resource type.

Returns one entry per (instance, dependency field) pair: an instance whose bundle declares a dependency slot referencing the resource type, plus the field name that receives it. Use this to see what a resource type is used by before changing or removing it.

The resourceTypeId accepts a bare identifier (aws-vpc) or a versioned one (aws-vpc@latest, aws-vpc@1.0.0). The version portion is accepted for a stable contract but is not yet used to match: bundles reference resource types without a version, so matching is resolved at the type level (the type's current 0.0.0 document). Version-specific matching becomes possible once bundles carry versioned resource-type references.

query {
  resourceTypeDependents(
    organizationId: "your-org-id"
    environmentId: "ecomm-production"
    resourceTypeId: "aws-vpc"
  ) {
    instance { id name }
    field
    resourceType { id name }
  }
}

resourceTypeDependents(
  organizationId: ID!
  environmentId: ID!
  resourceTypeId: ID!
): [ResourceTypeDependent!]!

Arguments

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

Your organization's unique identifier.

resourceTypeDependents.environmentId ● ID! non-null scalar {#environment-id}

The environment (identifier) to look for dependents in.

resourceTypeDependents.resourceTypeId ● ID! non-null scalar {#resource-type-id}

The resource type identifier (e.g., aws-vpc). A @<version> suffix (e.g., aws-vpc@1.0.0) is accepted but matching resolves at the type level.

Type

ResourceTypeDependent object

An instance that depends on a resource type, paired with the dependency field on its bundle that receives it.

An instance appears once per dependency field that references the resource type, so a bundle that depends on the same type through two fields yields two entries for that instance.