Help Search

Delete a group

Only a group manager or a user with administrator role can delete a group. A Group cannot be deleted as long as it is the sole owner of a shared resource. A Group can be deleted subject to relevant permissions by sending a DELETE request to /groups/<groupId>.json

DELETE /groups/<groupId>.json?api-version=v2

A dry run can also be performed before actually attempting to delete a group. This works as follow:

DELETE /groups/<groupId>/dry-run.json?api-version=v2

This will check all the constraints and return a 200 OK response if the group can be deleted safely.

Possible responses

Code Description
200 OK
Group deleted successfully.
400 Bad Request
The groupId supplied is not a valid UUID
403 Authentication Failure
The user making the request does not have the Admin role.
404 Not Found
The group either does not exist or the user making the request does not have delete permission.

Last updated

This article was last updated on April 23rd, 2019.

If you are familiar with the high level API concepts and only looking for the endpoint implementation details, there is a repository with the latest OpenAPI 2.0 specifications (compatible with Swagger).

OpenAPI Specs