← API reference
Mutation / devices

upsertControllerPolicy

Create or update the policy for a controller. Idempotent on controllerId (one row per controller). Wholesale-replace on both allowlists. Triggers a config.update push to the controller. Requires controller_policy:write permission.

Arguments

Policy contents

Returns UpsertControllerPolicyPayload!

Explore in a view

Device Fleet
View exact SDL
"""
Create or update the policy for a controller. Idempotent on controllerId (one row per controller). Wholesale-replace on both allowlists. Triggers a config.update push to the controller. Requires controller_policy:write permission.
"""
upsertControllerPolicy(
  """Policy contents"""
  input: UpsertControllerPolicyInput!
): UpsertControllerPolicyPayload! @topic(names: ["devices"])

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