---
name: metabase_list_groups
kind: function
lang: py
domain: infra
version: "1.0.0"
purity: impure
signature: "def metabase_list_groups(client: MetabaseClient) -> list[dict]"
description: "Lista todos los Permission Groups de Metabase con su member_count. Requiere superusuario. Endpoint: GET /api/permissions/group."
tags: [metabase, permissions, group, list, 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"
output: "list[dict]: lista de grupos con id, name y member_count"
tested: false
tests: []
test_file_path: ""
file_path: "python/functions/metabase/permissions.py"
---

## Ejemplo

```python
groups = metabase_list_groups(client)
for g in groups:
    print(g["id"], g["name"], g["member_count"])
```

## Notas

Incluye los grupos especiales del sistema: "All Users" (id=1) y "Administrators" (id=2).
Requiere que el cliente este autenticado como superusuario.
