Skip to content

Delete group

Request to delete a group:

DELETE /api/v2/groups/<group-id>.json

The group must have no members. Move or delete the users first.

Response contains HTTP status code as shown in the following table.

Response Description
200 OK The group has been successfully deleted
403 Forbidden The request cannot be completed because API user has no permission to delete groups
404 Not Found The ID is not a valid UUID
409 Conflict

The group still has members:

{"error": "NotEmptyError", "explanation": "Other resources refer to this one", "details": "Cannot delete a group, which has users"}