# delete_group

Delete a workspace group, revoking its role and cap from members.

Fails for identity-provider-managed groups (delete them in the IdP). Requires workspace  
billing-admin permission.

## Parameters

| Parameter         | Type          | Default | Description          |
| ----------------- | ------------- | ------- | -------------------- |
| group\_idrequired | string (uuid) | —       | The group to delete. |