# Mutations Use this page when you already know which write operation you need and want the exact public mutation surface of the Luxonis Hub GraphQL control API. Each supported mutation has its own section so you can link directly to it. > **Public mutation surface** > The public root mutation type is `PublicMutation`. Supported public mutations are available under `team { ... }`. ## About mutations Every GraphQL schema has a root mutation type. In Luxonis Hub, the public root mutation type is `PublicMutation`. Use this page to: * confirm the exact mutation name and argument names * check the top-level fields available on each mutation result type * link directly to one mutation field from guides or changelog entries If you need input object details such as `InstallAppOnDeviceInput` or `StartOTAOnDeviceInput`, continue to [Schema](https://docs.luxonis.com/cloud/api/reference/control-api/schema.md) or inspect the live schema through introspection. ## team Enter the authenticated team-scoped mutation surface. Path: `team` Type: `TeamScopedMutations!` All remaining mutation sections on this page are nested under `team` and use the path `team.`. ## abortOtaOnDevice Abort an OTA update already in progress on a device. Path: `team.abortOtaOnDevice` Returns: `AbortOTAOnDeviceResult!` ### Arguments for `abortOtaOnDevice` * `deviceId` (`ID!`): ID of the device whose OTA update you want to abort. ### Return fields for `abortOtaOnDevice` * `status` (`AbortOTAOnDeviceResultStatus!`): Outcome of the operation. * `failedMessage` (`String`): Failure details when the operation does not succeed. ## createAdoptKey Create an adopt key for device onboarding. Path: `team.createAdoptKey` Returns: `CreateAdoptKeyResult!` ### Arguments for `createAdoptKey` * `input` (`CreateAdoptKeyInput!`): Adopt key settings, including name, expiry, and remaining uses. ### Return fields for `createAdoptKey` * `status` (`CreateAdoptKeyResultStatus!`): Outcome of the operation. * `key` (`UUID`): Newly generated raw adopt key value. * `adoptKey` (`TeamAdoptKey`): Metadata for the created adopt key. ## createDeviceGroup Create a new device group. Path: `team.createDeviceGroup` Returns: `CreateDeviceGroupResult!` ### Arguments for `createDeviceGroup` * `input` (`CreateDeviceGroupInput!`): Device group settings. Currently this input contains the group name. ### Return fields for `createDeviceGroup` * `status` (`CreateDeviceGroupResultStatus!`): Outcome of the operation. * `deviceGroup` (`DeviceGroup`): Metadata for the created device group. ## deleteAdoptKey Delete an adopt key. Path: `team.deleteAdoptKey` Returns: `DeleteAdoptKeyResult!` ### Arguments for `deleteAdoptKey` * `adoptKeyId` (`ID!`): ID of the adopt key to delete. ### Return fields for `deleteAdoptKey` * `status` (`DeleteAdoptKeyResultStatus!`): Outcome of the operation. ## deleteDevice Delete a device record from the team. Path: `team.deleteDevice` Returns: `DeleteDeviceResult!` ### Arguments for `deleteDevice` * `deviceId` (`ID!`): ID of the device to delete. ### Return fields for `deleteDevice` * `status` (`DeleteDeviceResultStatus!`): Outcome of the operation. ## deleteDeviceApp Delete an installed device app from a device. Path: `team.deleteDeviceApp` Returns: `DeleteDeviceAppResult!` ### Arguments for `deleteDeviceApp` * `deviceAppId` (`ID!`): ID of the installed device app to delete. ### Return fields for `deleteDeviceApp` * `status` (`DeleteDeviceAppResultStatus!`): Outcome of the operation. * `failedMessage` (`String`): Failure details when the operation does not succeed. ## deleteDeviceGroup Delete a device group. Path: `team.deleteDeviceGroup` Returns: `DeleteDeviceGroupResult!` ### Arguments for `deleteDeviceGroup` * `deviceGroupId` (`ID!`): ID of the device group to delete. ### Return fields for `deleteDeviceGroup` * `status` (`DeleteDeviceGroupResultStatus!`): Outcome of the operation. ## deleteSnapsByFilter Delete snaps in bulk using a filter. Path: `team.deleteSnapsByFilter` Returns: `DeleteSnapsResult!` ### Arguments for `deleteSnapsByFilter` * `filter` (`EventSnapFilterInput!`): Filter used to select which snaps to delete. ### Return fields for `deleteSnapsByFilter` * `status` (`DeleteSnapsResultStatus!`): Outcome of the operation. * `bgTaskId` (`ID`): Background task ID to poll when deletion continues asynchronously. ## deleteSnapsByIds Delete a specific set of snaps by ID. Path: `team.deleteSnapsByIds` Returns: `DeleteSnapsResult!` ### Arguments for `deleteSnapsByIds` * `ids` (`[ID!]!`): IDs of the snaps to delete. ### Return fields for `deleteSnapsByIds` * `status` (`DeleteSnapsResultStatus!`): Outcome of the operation. * `bgTaskId` (`ID`): Background task ID to poll when deletion continues asynchronously. ## deviceGroupAddDevice Add one device to a device group. Path: `team.deviceGroupAddDevice` Returns: `AddDeviceToDeviceGroupResult!` ### Arguments for `deviceGroupAddDevice` * `deviceGroupId` (`ID!`): ID of the target device group. * `input` (`AddDeviceToDeviceGroupInput!`): Device-group assignment input. Currently this input contains the device ID. ### Return fields for `deviceGroupAddDevice` * `status` (`AddDeviceToDeviceGroupResultStatus!`): Outcome of the operation. ## deviceGroupRemoveDevice Remove one device from a device group. Path: `team.deviceGroupRemoveDevice` Returns: `RemoveDeviceFromDeviceGroupResult!` ### Arguments for `deviceGroupRemoveDevice` * `deviceGroupId` (`ID!`): ID of the device group. * `input` (`RemoveDeviceFromDeviceGroupInput!`): Device-group removal input. Currently this input contains the device ID. ### Return fields for `deviceGroupRemoveDevice` * `status` (`RemoveDeviceFromDeviceGroupResultStatus!`): Outcome of the operation. ## disableDeviceApp Disable an installed device app. Path: `team.disableDeviceApp` Returns: `DisableDeviceAppResult!` ### Arguments for `disableDeviceApp` * `deviceAppId` (`ID!`): ID of the installed device app to disable. ### Return fields for `disableDeviceApp` * `status` (`DisableDeviceAppResultStatus!`): Outcome of the operation. * `failedMessage` (`String`): Failure details when the operation does not succeed. ## enableDeviceApp Enable an installed device app. Path: `team.enableDeviceApp` Returns: `EnableDeviceAppResult!` ### Arguments for `enableDeviceApp` * `deviceAppId` (`ID!`): ID of the installed device app to enable. ### Return fields for `enableDeviceApp` * `status` (`EnableDeviceAppResultStatus!`): Outcome of the operation. * `failedMessage` (`String`): Failure details when the operation does not succeed. ## installAppOnDevice Install an app on a device. Path: `team.installAppOnDevice` Returns: `InstallAppOnDeviceResult!` ### Arguments for `installAppOnDevice` * `deviceId` (`ID!`): ID of the device where the app should be installed. * `input` (`InstallAppOnDeviceInput!`): Installation settings, including app identifier, optional version, environment, and start behavior. ### Return fields for `installAppOnDevice` * `status` (`InstallAppOnDeviceResultStatus!`): Outcome of the operation. * `failedMessage` (`String`): Failure details when the operation does not succeed. ## rebootDevice Reboot a device. Path: `team.rebootDevice` Returns: `RebootDeviceResult!` ### Arguments for `rebootDevice` * `deviceId` (`ID!`): ID of the device to reboot. ### Return fields for `rebootDevice` * `status` (`RebootDeviceResultStatus!`): Outcome of the operation. * `failedMessage` (`String`): Failure details when the operation does not succeed. ## renameDeviceGroup Rename an existing device group. Path: `team.renameDeviceGroup` Returns: `RenameDeviceGroupResult!` ### Arguments for `renameDeviceGroup` * `deviceGroupId` (`ID!`): ID of the device group to rename. * `input` (`RenameDeviceGroupInput!`): Rename input. Currently this input contains the new group name. ### Return fields for `renameDeviceGroup` * `status` (`RenameDeviceGroupResultStatus!`): Outcome of the operation. ## requestDeviceAppConnection Request connection details for a device app session. Path: `team.requestDeviceAppConnection` Returns: `RequestDeviceAppConnectionResult!` ### Arguments for `requestDeviceAppConnection` * `deviceAppId` (`ID!`): ID of the installed device app to connect to. ### Return fields for `requestDeviceAppConnection` * `status` (`RequestDeviceAppConnectionResultStatus!`): Outcome of the operation. * `failedMessage` (`String`): Failure details when the operation does not succeed. * `connection` (`AppConnectionResponse`): Connection payload. If present, select `deviceAppId` and `state`. ## requestDeviceWebrtcConfig Request browser-side WebRTC bootstrap details for a device. Path: `team.requestDeviceWebrtcConfig` Returns: `RequestDeviceWebrtcConfigResult!` ### Arguments for `requestDeviceWebrtcConfig` * `deviceId` (`ID!`): ID of the device to connect to. ### Return fields for `requestDeviceWebrtcConfig` * `status` (`RequestDeviceWebrtcConfigResultStatus!`): Outcome of the operation. * `failedMessage` (`String`): Failure details when the operation does not succeed. * `config` (`WebRtcConfigResponse`): WebRTC bootstrap payload. If present, select `authToken` and `clientId`. ## revokeAdoptKey Revoke an adopt key without deleting its record. Path: `team.revokeAdoptKey` Returns: `RevokeAdoptKeyResult!` ### Arguments for `revokeAdoptKey` * `adoptKeyId` (`ID!`): ID of the adopt key to revoke. ### Return fields for `revokeAdoptKey` * `status` (`RevokeAdoptKeyResultStatus!`): Outcome of the operation. ## setDeviceAppConfig Update runtime configuration for a device app. Path: `team.setDeviceAppConfig` Returns: `SetDeviceAppConfigResult!` ### Arguments for `setDeviceAppConfig` * `deviceAppId` (`ID!`): ID of the installed device app to configure. * `input` (`SetDeviceAppConfigInput!`): Configuration update, including the environment object and restart behavior. ### Return fields for `setDeviceAppConfig` * `status` (`SetDeviceAppConfigResultStatus!`): Outcome of the operation. * `failedMessage` (`String`): Failure details when the operation does not succeed. ## startDeviceApp Start an installed device app. Path: `team.startDeviceApp` Returns: `StartDeviceAppResult!` ### Arguments for `startDeviceApp` * `deviceAppId` (`ID!`): ID of the installed device app to start. * `input` (`StartDeviceAppInput!`): Runtime overrides such as environment changes or app enablement behavior. ### Return fields for `startDeviceApp` * `status` (`StartDeviceAppResultStatus!`): Outcome of the operation. * `failedMessage` (`String`): Failure details when the operation does not succeed. ## startOtaOnDevice Start an OTA update on a device. Path: `team.startOtaOnDevice` Returns: `StartOTAOnDeviceResult!` ### Arguments for `startOtaOnDevice` * `deviceId` (`ID!`): ID of the device to update. * `input` (`StartOTAOnDeviceInput!`): OTA settings, including firmware ID and optional reboot behavior. ### Return fields for `startOtaOnDevice` * `status` (`StartOTAOnDeviceResultStatus!`): Outcome of the operation. * `failedMessage` (`String`): Failure details when the operation does not succeed. ## stopDeviceApp Stop a running device app. Path: `team.stopDeviceApp` Returns: `StopDeviceAppResult!` ### Arguments for `stopDeviceApp` * `deviceAppId` (`ID!`): ID of the installed device app to stop. ### Return fields for `stopDeviceApp` * `status` (`StopDeviceAppResultStatus!`): Outcome of the operation. * `failedMessage` (`String`): Failure details when the operation does not succeed. ## Related docs ### Schema Inspect the live schema endpoint, SDL workflow, and introspection options. [Schema](https://docs.luxonis.com/cloud/api/reference/control-api/schema.md) ### Types Inspect the public object and connection types used by mutation results. [Types](https://docs.luxonis.com/cloud/api/reference/control-api/types.md) ### Queries Switch to the supported public read operations for the same API surface. [Queries](https://docs.luxonis.com/cloud/api/reference/control-api/queries.md) ### About GraphQL Return to request shape, authentication, and public API boundaries. [About GraphQL](https://docs.luxonis.com/cloud/api/graphql.md)