---
name: metabase_delete_group
kind: function
lang: py
domain: infra
version: "1.0.0"
purity: impure
signature: "def metabase_delete_group(client: MetabaseClient, group_id: int) -> None"
description: "Elimina permanentemente un Permission Group de Metabase. IRREVERSIBLE. No borra los usuarios, solo el grupo. Endpoint: DELETE /api/permissions/group/:id."
tags: [metabase, permissions, group, delete, api, python]
uses_functions: []
uses_types: []
returns: []
returns_optional: false
error_type: "error_go_core"
imports: []
params:
  - name: client
    desc: "instancia autenticada de MetabaseClient con permisos de superusuario"
  - name: group_id
    desc: "ID numerico del grupo a eliminar. ADVERTENCIA: no pasar id=1 (All Users) ni id=2 (Administrators)"
output: "None: retorna None en caso de exito (204 No Content)"
tested: false
tests: []
test_file_path: ""
file_path: "python/functions/metabase/permissions.py"
---

## Ejemplo

```python
metabase_delete_group(client, 5)
# CUIDADO: no pasar group_id=1 (All Users) ni group_id=2 (Administrators)
```

## Notas

**OPERACION IRREVERSIBLE.** El grupo se elimina permanentemente sin posibilidad de recuperacion.

Grupos especiales del sistema que NO deben borrarse:
- `id=1`: "All Users" — todos los usuarios de Metabase pertenecen automaticamente a este grupo.
- `id=2`: "Administrators" — grupo de administradores del sistema.

Esta funcion NO valida ni bloquea el borrado de esos IDs. Es responsabilidad del caller verificar que no se pasen IDs protegidos antes de invocar esta funcion.

Al borrar un grupo, los usuarios que pertenecian a el no se eliminan, solo pierden la membresia.
Error 404 si el grupo no existe.