Delete a subgroup
DELETE/v1/groups/:groupId/subgroups/:subGroupId
Deletes an empty subgroup. The subgroup must have no nodes; otherwise the request is rejected with 409. Remove all nodes from the subgroup first, then delete it.
- Removes the subgroup from the database.
- Removes associated user-subgroup mappings.
- Does NOT delete the nodes.
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 409
- 500
Successful deletion
Bad request
Unauthorized - Invalid or missing authentication
Forbidden - User does not have permission to access the resource
Subgroup not found
Subgroup is not empty (still has nodes)
Internal server error