← API reference
Mutation / devices

upgradeEdgeAppInstallation

Repoint an installation at a different version of the same edgeApp. Validates the target row exists, belongs to this tenant, shares the installation's current handle, and isn't a DRAFT (only PUBLISHED or DEPRECATED versions can be pinned). Pushes config.update to the controller. The bridge reconciles by installation.id+version, so the new version triggers a restart with the new content. Requires edge_app_installation:write.

Arguments

Edge app installation ID to upgrade

Upgrade input

Returns UpsertEdgeAppInstallationPayload!

Explore in a view

Device Fleet
View exact SDL
"""
Repoint an installation at a different version of the same edgeApp. Validates the target row exists, belongs to this tenant, shares the installation's current handle, and isn't a DRAFT (only PUBLISHED or DEPRECATED versions can be pinned). Pushes config.update to the controller. The bridge reconciles by `installation.id`+`version`, so the new version triggers a restart with the new content. Requires edge_app_installation:write.
"""
upgradeEdgeAppInstallation(
  """Edge app installation ID to upgrade"""
  id: EdgeAppInstallationID!
  """Upgrade input"""
  input: UpgradeEdgeAppInstallationInput!
): UpsertEdgeAppInstallationPayload! @topic(names: ["devices"])

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