---
title: "Cache"
description: "Vide le cache de dérivées Glide (MEDIA_CACHE_PATH). Le cache est de la donnée purement dérivée, régénérée paresseusement à la prochaine requête image — il…"
---

## `POST /admin/cache/purge`

Vide le cache de dérivées Glide (`MEDIA_CACHE_PATH`). Le cache est de la donnée purement dérivée, régénérée paresseusement à la prochaine requête image — il est donc toujours sûr à vider (au coût d'un recalcul ponctuel sur les hits suivants). Cas d'usage : récupérer du disque, ou forcer la régénération après un changement de config Glide / de source. Le répertoire racine est préservé (recréé si absent) : seul son **contenu** est supprimé.

**Sécurité — dry-run par défaut.** Sans `?delete=1`, l'endpoint ne fait que **mesurer** (nombre de fichiers + octets) ce qu'il supprimerait.

**Query params**
- `delete` (bool, optionnel) : `1` / `true` pour réellement vider. Défaut off (dry-run).

**Réponse (200)**

```json
{
  "status":     "ok",
  "dryRun":     true,
  "files":      48213,
  "bytes":      1734209922,
  "deleted":    0,
  "durationMs": 5310
}
```

| Champ | Sens |
|---|---|
| `dryRun` | `true` tant que `?delete=1` n'est pas passé |
| `files` / `bytes` | volume trouvé dans le cache |
| `deleted` | fichiers réellement supprimés (`0` en dry-run) |

**Erreurs**

| Status | Body | Sens |
|---|---|---|
| `403` | `{ "error": "..." }` | auth KO |

**Exemple curl**

```bash
# Mesure
curl -s -X POST -H "Authorization: Bearer $ADMIN_API_TOKEN" \
  "http://hydrogen.dev.com/admin/cache/purge"

# Purge effective
curl -s -X POST -H "Authorization: Bearer $ADMIN_API_TOKEN" \
  "http://hydrogen.dev.com/admin/cache/purge?delete=1"
```

---