Delete group
Relative path: /v1/groups/{groupUuid}
Delete the group referenced by the uuid and any groups under it. If there are objects under the deleted groups, all of them will be deleted as well.
It is not possible to delete a group that has a linked entity (CUSTOMER, MSP, ...).
Query parameters
Name |
Type |
Description |
|---|---|---|
releaseConsumedUnits |
boolean |
For any deleted object within the group, all the associated units will be released. For devices, the seat of any active product on deleted devices will be released (and can be used again). If there were multiple active products on the deleted device, all of them are deactivated. Similarly, if there is a product consuming users (for example, mail server security), all the users will be released after the deletion of the device.
|
Parameters in path
Name |
Type |
Required |
Description |
|---|---|---|---|
groupUuid |
string |
Yes |
Reference to the group that is the root of the deleted subtree. type: Group |
Responses
Display Schema instead of an Example or vice-versa
Code |
Description |
Example |
Schema |
|---|---|---|---|
200 |
Successful response. |
{} |
{
"$ref": "v1DeleteGroupResponse",
"title": "empty",
"type": "object"
} |
202 |
Response took too long; request cached. Response can be retrieved later using the response-id header. |
null |
[] |
400 |
One of the errors: 1. Bad or missing authorization. 2. Validation error. Invalid argument provided. |
null |
[] |
401 |
Token has expired or is invalid. |
null |
[] |
403 |
Access denied. Check permissions. |
null |
[] |
404 |
Requested resource not found. |
null |
[] |
429 |
Rate limit reached. Try again later. |
null |
[] |
500 |
Internal server failure. Try again later. |
null |
[] |
502 |
Internal server failure. Try again later. |
null |
[] |
503 |
Environment under maintenance. Try again later. |
null |
[] |
504 |
Action took too long; timeout reached |
null |
[] |