Delete group

Relative path: /v1/groups/{groupUuid}

Delete Group referenced by uuid and any groups under it. If there are objects under 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, seat of any active product on deleted devices will be released (and can be used again). If there were multiple products active on the deleted device, all of them are deactivated. Similarly, if there is a product consuming users (e.g. mail server security), all the users will be released upon deletion of the device. Note: As of 2024H2 only seats are released.

Parameters in path

Name	Type	Required	Description
groupUuid	string	Yes	Reference to the group which is root of 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	[]

˄˅