← API reference
Mutation / integrations

upgradeIntegrationInstance

Move an integration instance to a newer version of the same integration. Runs the new definition's upgrade hook between stop and start. Requires integrationInstance:write permission.

Arguments

Integration instance ID to upgrade

Integration instance upgrade input

Returns IntegrationInstancePayload!

Explore in a view

Integrations
View exact SDL
"""
Move an integration instance to a newer version of the same integration. Runs the new definition's upgrade hook between stop and start. Requires integrationInstance:write permission.
"""
upgradeIntegrationInstance(
  """Integration instance ID to upgrade"""
  id: IntegrationInstanceID!
  """Integration instance upgrade input"""
  input: UpgradeIntegrationInstanceInput!
): IntegrationInstancePayload! @topic(names: ["integrations"])

Schema reference describes the API contract. Actual access is checked by the platform for every operation.