IntegrationInstanceState
An integration instance (live installation of a definition)
Unique identifier
Tenant ID
nameString!User-provided name for this instance
descriptionStringOptional description
Reference to the integration definition. Changing it upgrades the instance.
The integration this instance is installed from. Its publishedVersion is the default for new installs; this instance stays on definitionId until it is upgraded.
integrationIdString!Integration identifier (e.g., com.acme.erp-connector)
versionString!Version of the definition this instance is using
Current status
Bot user assigned to run this integration
configString!User configuration (JSON). Secret keys are omitted — see secrets.
Per-key state of this instance's secrets: which are set and when each last changed. Never carries a value.
bindingsString!Resource bindings (JSON)
Operational state (health, last run, etc.)
createdAtString!Creation timestamp (ISO8601)
updatedAtString!Last update timestamp (ISO8601)
View exact SDL
"""An integration instance (live installation of a definition)"""
type IntegrationInstanceState @iac_resource(name: "integration_instance") @iac_ops(create: "createIntegrationInstance", read: "getIntegrationInstance", update: "updateIntegrationInstance", delete: "deleteIntegrationInstance") @iac_writeGroup(name: "upgrade", operation: "upgradeIntegrationInstance", trigger: ["definitionId"], note: "stops the instance, runs the new version's upgrade hook, and starts it again") {
"""Unique identifier"""
id: IntegrationInstanceID! @iac_identity(assignedBy: USER) @iac_createOnly
"""Tenant ID"""
tenantId: TenantID! @iac_computed
"""User-provided name for this instance"""
name: String!
"""Optional description"""
description: String
"""
Reference to the integration definition. Changing it upgrades the instance.
"""
definitionId: IntegrationDefinitionID! @iac_ref(resource: "integration_definition") @iac_groupInput(group: "upgrade", path: "input.toDefinitionId")
"""
The integration this instance is installed from. Its publishedVersion is the default for new installs; this instance stays on definitionId until it is upgraded.
"""
integration: Integration @iac_computed
"""Integration identifier (e.g., com.acme.erp-connector)"""
integrationId: String! @iac_computed
"""Version of the definition this instance is using"""
version: String! @iac_computed
"""Current status"""
status: IntegrationInstanceStatus! @iac_computed
"""Bot user assigned to run this integration"""
botUserId: UserID @iac_ref(resource: "service_account")
"""User configuration (JSON). Secret keys are omitted — see `secrets`."""
config: String! @iac_artifact(language: JSON, validators: ["integration-config"]) @iac_groupInput(group: "upgrade", path: "input.configOverrides")
"""
Per-key state of this instance's secrets: which are set and when each last changed. Never carries a value.
"""
secrets: [IntegrationSecretStatus!]! @iac_computed
"""Resource bindings (JSON)"""
bindings: String! @iac_compare(as: JSON) @iac_groupInput(group: "upgrade", path: "input.bindings")
"""Operational state (health, last run, etc.)"""
operationalState: IntegrationOperationalState! @iac_computed
"""Creation timestamp (ISO8601)"""
createdAt: String! @iac_computed
"""Last update timestamp (ISO8601)"""
updatedAt: String! @iac_computed
}One stable address across all schema views. Follow a field’s type to explore connections between domains.