> ## Documentation Index
> Fetch the complete documentation index at: https://docs.headlesslabs.xyz/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Cases

> Los casos unifican acciones de moderación de Headless en un historial por servidor. Usa el ID del caso para revisar el detalle, anotar seguimiento o corregir su motivo.

## Consultar y filtrar

`.cases [miembro]` (aliases `.cl` y `.caselist`) lista los casos de este servidor y permite filtrar por miembro; `/cases [member]` ofrece el mismo filtro. Ambas listas usan páginas de diez, se publican en el canal y sus botones los puede usar quien las abrió o alguien con `Moderate Members` nativo. Si el filtro de prefijo no resuelve un miembro, el runtime actual puede dejar la lista sin filtrar: confirma los resultados antes de seguir. `.case <id>` o `/case case_id:<id>` abre el registro. Los comandos requieren `Moderate Members` (nativo o mediante Fake Permissions compatible).

Cada ficha puede incluir acción, objetivo, moderador, motivo, fecha, fuente, duración opcional, metadatos y notas. El panel individual muestra como máximo las dos notas recientes; las notas no llevan una marca de tiempo propia.

### `.cases`

```headless-command Syntax theme={null}
.cases [user_query]
```

```headless-command Example theme={null}
.cases
```

También funciona: `.cases @miembro`

### `/cases`

```headless-command Syntax theme={null}
/cases [member:<member>]
```

```headless-command Example theme={null}
/cases member:@miembro
```

### `.case`

```headless-command Syntax theme={null}
.case <case_id>
```

```headless-command Example theme={null}
.case 42
```

### `/case`

```headless-command Syntax theme={null}
/case case_id:<case_id>
```

```headless-command Example theme={null}
/case case_id:42
```

## Notas y edición

`.casenote <id> <texto>` añade una nota al caso y `.caseedit <id> <motivo>` actualiza el motivo. Ambas son solo de prefijo y guardan sobre el registro existente; confirma el ID antes de editar. Las notas guardan el nombre del moderador, pero no una marca de tiempo propia.

### `.casenote`

```headless-command Syntax theme={null}
.casenote <case_id> <note>
```

```headless-command Example theme={null}
.casenote 42 apelación revisada
```

### `.caseedit`

```headless-command Syntax theme={null}
.caseedit <case_id> <new_reason>
```

```headless-command Example theme={null}
.caseedit 42 Apelación aceptada
```

## Importar Audit Log

`.caseimport [límite]` (aliases `.importcases` y `.auditcases`) importa entradas compatibles del Audit Log. Es un comando de prefijo; no hay variante slash. Quien lo ejecuta necesita `View Audit Log` y `Moderate Members`, y Headless necesita `View Audit Log`. El límite predeterminado es 75 y el runtime lo limita al rango de 1–200; duplicados y acciones incompatibles se omiten. El importador reconoce ban, unban, kick, eliminación individual o masiva de mensajes, cambios/creación/eliminación de roles y eliminación de canales. Actualmente clasifica cualquier entrada `member_update` como timeout, por lo que revisa esos casos importados antes de usarlos como prueba de una sanción concreta.

### `.caseimport`

```headless-command Syntax theme={null}
.caseimport [limit=75]
```

```headless-command Example theme={null}
.caseimport 75
```

> [!WARNING]
>
> La importación consulta el Audit Log y crea registros persistentes; su máximo es 200 entradas. Revisa importados, omitidos y errores. `.caseedit` no conserva automáticamente el motivo anterior ni produce un evento de auditoría independiente; prioriza `.casenote` cuando necesites dejar contexto.

## Correcciones y preservación del historial

`.casenote <id> <nota>` es la opción para añadir contexto sin reemplazar la razón original. `.caseedit <id> <nueva razón>` (alias `.ce`) sobrescribe la razón en el registro existente; hoy el callback no añade una nota, no guarda el valor anterior ni crea un caso/log de edición. Por eso, usa notas para apelaciones o correcciones y reserva `caseedit` para una corrección deliberada, después de confirmar el ID.

## Pasos

**1. Localiza el caso**

Usa `.cases` o filtra por miembro para recorrer listas largas.

**2. Confirma ID y objetivo**

Abre `.case <id>` antes de añadir una nota o corregir el motivo.

**3. Importa solo si hace falta**

Concede `View Audit Log` temporalmente si tu política lo permite y revisa el resumen.

## Páginas relacionadas

* [Advertencias](/docs/security/warnings.md)
* [Configuración de moderación](/docs/security/moderation.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.