Update Device State ID to Unmanage a Device
post
/api/device/DeviceManagement/updateUnmanageDevice
Unmanages the specified device by setting the device state ID to static. At minimum, either the DeviceGroupID or Devices property is required in the request body.
Request
There are no request parameters for this operation.
Supported Media Types
- application/json
Root Schema : schema
Type:
Show Source
object
-
DeviceGroupID: integer
The ID of the device group containing the devices to be unmanaged. Either Devices or DeviceGroupID parameter is required.
-
Devices: integer
The comma-separated list of device IDs to unmanage. Either Devices or DeviceGroupID parameter is required.
-
RecursiveGroup: boolean
Whether all the descending devices from the device group specified by DeviceGroupID are being unmanaged (true) or not (false).
Response
Supported Media Types
- application/json
200 Response
Successful operation
Root Schema : schema
Match All
Show Source
-
object
SuccessfulUpdateOperation
The response body for a successful update operation.
-
object
type
Nested Schema : SuccessfulUpdateOperation
Type:
object
The response body for a successful update operation.
Show Source
-
message: string
The response message.Example:
Updated record
-
success: boolean
Whether the operation was a success (true) or a failure (false).Example:
true
Default Response
Failed operation
Root Schema : schema
Type:
Show Source
object
-
errors: array
errors
The list of errors reported. Validation errors will be keyed by record field.
-
message: string
The response message.Example:
Exception thrown
-
success: boolean
Whether the operation was a success (true) or a failure (false).Example:
false
Nested Schema : errors
Type:
array
The list of errors reported. Validation errors will be keyed by record field.
Show Source
-
Array of:
object items
An error.
Nested Schema : items
Type:
object
An error.