> ## 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.

# Purge

> Purge elimina mensajes del canal actual con filtros opcionales. La operación está limitada por el máximo configurado para el servidor y registra el resultado en Logs.

## Permisos y límite

Quien ejecuta el comando necesita `Manage Messages`; Headless también necesita `Manage Messages`. Configura el máximo en Dashboard → Moderation → Max purge; el valor predeterminado del runtime es 500. Las solicitudes por encima del máximo se rechazan.

## Filtros de prefijo

Puedes borrar todo, mensajes de un miembro o filtrar por `bots`, `links`, `images`, `invites`, `embeds`, `mentions` o `contains <texto>`. Si omites la cantidad en una búsqueda por miembro, el prefijo revisa los mensajes eliminables de ese usuario en el canal; otros usos usan el límite configurado.

### `.purge — 1`

```headless-command Syntax theme={null}
.purge [args...]
```

```headless-command Example theme={null}
.purge 50
```

También funciona: `.purge @miembro 20` · `.purge links 50`

### `.purge — 2`

```headless-command Syntax theme={null}
.purge [args...]
```

```headless-command Example theme={null}
.purge contains invitación 30
```

También funciona: `.purge mentions 25`

### `.purge [args...]`

```headless-command Syntax theme={null}
.purge [args...]
```

```headless-command Example theme={null}
.purge 50
```

También funciona: `.purge @miembro 20` · `.purge links 50` · `.purge contains invitación 30` · `.purge mentions 25`

> [!WARNING]
>
> Eliminar mensajes es irreversible desde Headless. Verifica canal, filtro y cantidad antes de ejecutar; el escaneo filtrado está acotado por el runtime.

## Slash

`/purge` admite cantidad opcional, miembro opcional y filtros `all`, `bots`, `links`, `invites`, `images` y `embeds`. No incluye los filtros textuales ni `mentions` del comando de prefijo.

### `/purge`

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

```headless-command Example theme={null}
/purge amount:50 filter_type:links
```

### `/purge`

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

```headless-command Example theme={null}
/purge amount:50 filter_type:links
```

### `.purge — 2`

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

```headless-command Example theme={null}
/purge amount:50 filter_type:links
```

## Pasos

**1. Escoge canal y filtro**

Comprueba el canal actual; el comando de prefijo no acepta selector de canal.

**2. Establece un límite explícito**

Usa una cantidad menor para búsquedas filtradas y verifica el máximo del servidor.

**3. Revisa el resultado**

Los mensajes inaccesibles o sujetos a límites de Discord pueden quedar sin borrar.

## Límites del borrado

> **Mensajes antiguos y fijados**
>
> Headless omite mensajes fijados y mensajes con más de 14 días. Discord no permite borrarlos en bloque; revisa el conteo de omitidos en el resultado.

> **Ventana de búsqueda para filtros**
>
> Un filtro prefix con cantidad busca en una ventana de mensajes recientes, hasta 1.500. La excepción es `.purge @miembro` sin cantidad: recorre los mensajes eliminables de ese miembro hasta encontrar mensajes de más de 14 días. Si un filtro con cantidad no encuentra suficientes coincidencias en su ventana, revisa el canal antes de volver a ejecutar una búsqueda menor.

> **Caso y registro**
>
> Una operación prefix terminada genera un caso y programa el evento de Logs. Slash registra el evento de Logs, pero no crea el caso que crea la ruta prefix. Un fallo de acceso o de la API puede dejar mensajes sin borrar; el resumen no garantiza que se borraran todos los mensajes coincidentes.

## Sintaxis y ejemplos

#### `.purge — 1`

## Páginas relacionadas

* [Logs](/docs/server/logging.md)
* [Snipes](/docs/community/snipes.md)


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