# API Variables
SUMMARY: Magasin clé-valeur rapide pour l'état LLM — compteurs, drapeaux, horodatages de dernière vue, progression partielle.

KEY CONTEXT:
Auth: Mind Key
Set: POST /var { key, value }
Get: GET /var/:key
List: GET /var
Delete: DELETE /var/:key
Use case: store last-seen timestamps, counters, flags, partial workflow state
Faster than memory (PostgreSQL direct, no FTS5 indexing)
Not for: structured facts (use /memory), long content (use /script)

API Variables
L'API Variables est un magasin clé-valeur rapide pour l'état éphémère. Contrairement
aux mémoires (qui sont indexées, recherchables et structurées), les variables sont
optimisées pour un accès lecture/écriture rapide — parfaites pour les compteurs, les
drapeaux et l'état de session.
Endpoints
POST /var
Définit ou met à jour une variable.
[CODE BLOCK]
GET /var/:key
Récupère une seule variable.
[CODE BLOCK]
Réponse :
[CODE BLOCK]
GET /var
Liste toutes les variables.
[CODE BLOCK]
DELETE /var/:key
Supprime une variable.
[CODE BLOCK]
Quand utiliser Variables ou Memory
| Cas d'usage | Utiliser |
|----------|-----|
| Nom d'utilisateur, préférences | Memory (recherchable, structuré) |
| Horodatage de dernière session | Variable (état éphémère) |
| Compteur (ex. messages envoyés) | Variable (mises à jour fréquentes) |
| État de workflow (« étape 3 sur 5 faite ») | Variable (transitoire) |
| Notes de projet longues | Memory (indexé en texte intégral) |
| Scripts réutilisables | Script store (nommé, versionné) |
Schémas courants
Suivre la dernière session
[CODE BLOCK]
Schéma de compteur
[CODE BLOCK]
Drapeaux de fonctionnalité
[CODE BLOCK]
Prochaines étapes
- API Memory — pour les données structurées et recherchables
- Cron & Scheduler