DELETE/api/groups/{groupId}

Delete a group

Deletes a group identified by its group ID. Use this operation when you no longer need the group and its associated configuration.

1 parameter
groupIdstringrequired
The unique identifier of the group to delete.

5 status codes
200Returns a status indicating the result of the group deletion.
400Returned when the request is invalid.
401Returned when authentication is missing or invalid.
403Returned when the authenticated user is not permitted to delete the group.
500Returned when an internal server error occurs.

Error handling

A 400 is returned when the request is invalid; a 401 is returned when authentication is missing or invalid; a 403 is returned when the authenticated user is not permitted to delete the group; and a 500 is returned when an internal server error occurs. The groupId path parameter must identify the group to delete.