DELETE
/organization/groups/{group_id}Delete a group
Deletes a group from the organization. Use the group's identifier to select which group to remove. The response confirms the deleted group by its identifier and deletion status.
group_idstringrequired
The identifier of the group to delete.
200Returns a confirmation containing the `group.deleted` object type, the deleted group's identifier, and a boolean indicating whether it was deleted.
objectstringrequired
Always `group.deleted`.
idstringrequired
Identifier of the deleted group.
deletedbooleanrequired
Whether the group was deleted.
400Returned when the request parameters are invalid or the requested operation cannot be performed.
errorobjectrequired
403Returned when the authenticated user does not have permission to perform the operation.
errorobjectrequired
Details about the permission error.
404Returned when the endpoint is unavailable.
errorobjectrequired
429Returned when the request is rejected because a rate limit was exceeded.
errorobjectrequired
Error handling
A 400 is returned when the request parameters are invalid or the operation cannot be performed; a 403 when the authenticated user lacks permission; a 404 when the endpoint is unavailable; and a 429 when the rate limit is exceeded. The group_id path parameter identifies the group to delete.