diff --git a/common/nyora-doc-api-hermes-guide.md b/common/nyora-doc-api-hermes-guide.md
index 0352214..315dcab 100644
--- a/common/nyora-doc-api-hermes-guide.md
+++ b/common/nyora-doc-api-hermes-guide.md
@@ -157,3 +157,39 @@ mérite une relecture rapide côté PowerPoint.
 Limite connue de ce QC : il porte uniquement sur le mode données (JSON), pas
 sur le mode template — cohérent avec la limitation de restyle déjà
 documentée ci-dessus.
+
+## Panne corrigée le 03/07/2026 — clé absente du runtime Hermes-TT
+
+**Symptôme** : Hermes-TT échouait à appeler `nyora-doc-api` (401), malgré cette
+documentation mentionnant correctement le header `x-api-key` et sa valeur.
+
+**Cause réelle** : la variable `NYORA_DOC_API_KEY` n'existait ni dans
+`/volume1/docker/hermes-platform/.env`, ni — surtout — dans le bloc
+`environment:` des 3 services (`hermes-agent-tt/nyora/perso`) du
+`docker-compose.yml` d'hermes-platform. Ce fichier whiteliste explicitement
+chaque variable transmise au container : `NYORA_DOC_API_URL` y était bien
+présente, mais `NYORA_DOC_API_KEY` n'avait jamais été ajoutée. Résultat :
+même avec un `.env` correct, la clé n'atteignait jamais le container.
+
+**Correctif appliqué** :
+1. Ajout de `NYORA_DOC_API_URL` + `NYORA_DOC_API_KEY=nyora-doc-2026` au `.env`
+   (section "Services NAS"), suppression au passage des lignes mortes
+   `PANDOC_URL`, `CARBONE_URL`, `GOTENBERG_URL`, `PPTX_API_URL`,
+   `DOCUMENT_FACTORY_URL`, `TIKA_URL` (services désinstallés).
+2. Ajout de `NYORA_DOC_API_KEY: ${NYORA_DOC_API_KEY}` dans le bloc
+   `environment:` des 3 services du `docker-compose.yml`.
+3. `docker compose up -d hermes-agent-tt hermes-agent-nyora hermes-agent-perso`
+   pour recréer les 3 containers.
+4. Vérifié : `env | grep NYORA_DOC_API_KEY` dans les 3 containers, puis test
+   `curl -H "x-api-key: $NYORA_DOC_API_KEY" $NYORA_DOC_API_URL/v1/templates`
+   depuis `hermes-agent-tt` → `200`.
+
+**Leçon** : dans ce projet, ajouter une variable au `.env` ne suffit **pas** —
+elle doit aussi être déclarée explicitement dans le bloc `environment:` de
+chaque service du `docker-compose.yml` d'hermes-platform. Réflexe à avoir
+pour toute nouvelle intégration (vérifier les 2 fichiers, pas un seul).
+
+Skill `hermes-tt/data/skills/achats/email-html-marches/references/nyora-doc-api.md`
+corrigé en parallèle (il indiquait un header incertain `X-API-Key`/`api-key`
+et une clé "non trouvée" — remplacé par le header exact `x-api-key` et un
+renvoi à la variable d'environnement plutôt qu'une valeur en clair).