← API reference
Mutation / devices

deprecateEdgeApp

Mark a PUBLISHED row as DEPRECATED. Used to retire an app without a replacement. Existing installations stay pinned and keep working until upgraded or uninstalled. Idempotent on already-DEPRECATED rows; rejects DRAFT rows (delete them instead). Requires edge_app:write permission.

Arguments

PUBLISHED edge app ID to deprecate

Returns UpsertEdgeAppPayload!

Explore in a view

Device Fleet
View exact SDL
"""
Mark a PUBLISHED row as DEPRECATED. Used to retire an app without a replacement. Existing installations stay pinned and keep working until upgraded or uninstalled. Idempotent on already-DEPRECATED rows; rejects DRAFT rows (delete them instead). Requires edge_app:write permission.
"""
deprecateEdgeApp(
  """PUBLISHED edge app ID to deprecate"""
  id: EdgeAppID!
): UpsertEdgeAppPayload! @topic(names: ["devices"])

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