Cache

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)

{
  "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

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

---