Delete Organization Groups
DELETE/iot/pub/v1/organization/group
Delete one or more groups. The request takes a JSON body: one item, or an array of up to 1000 items, each with the name of a group.
The subgroups and sites of a deleted group are not deleted; they move to its parent group. If the parent is deleted in the same request, they move to the nearest group above it that is not deleted. Sites that move to the top-level group are no longer in any group. No site or device data is removed.
The request is all or nothing: if any group is rejected (for example a name that does not exist or is listed twice), the request returns HTTP 400 and no group is deleted. The top-level group cannot be deleted.
An account that has access to only some groups can change only those groups and the groups beneath them; for any other group the request returns HTTP 400.
Request
Responses
- 200
- 4XX
- 5XX
Groups Successfully Deleted
Client Error Response
Server Error Response