# Variables API
SUMMARY: Snelle key-value-opslag voor LLM-staat — tellers, vlaggen, laatst-gezien-tijdstempels, gedeeltelijke voortgang.

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)

Variables API
De Variables API is een snelle key-value-opslag voor efemere staat. In tegenstelling
tot herinneringen (die geïndexeerd, doorzoekbaar en gestructureerd zijn), zijn variabelen
geoptimaliseerd voor snelle lees/schrijftoegang — perfect voor tellers, vlaggen en
sessiestaat.
Eindpunten
POST /var
Stel een variabele in of werk deze bij.
[CODE BLOCK]
GET /var/:key
Haal één variabele op.
[CODE BLOCK]
Respons:
[CODE BLOCK]
GET /var
Toon alle variabelen.
[CODE BLOCK]
DELETE /var/:key
Verwijder een variabele.
[CODE BLOCK]
Wanneer variabelen versus memory gebruiken
| Gebruik | Gebruik |
|---------|---------|
| Gebruikersnaam, voorkeuren | Memory (doorzoekbaar, gestructureerd) |
| Laatste sessie-tijdstempel | Variable (efemere staat) |
| Teller (bijv. verzonden berichten) | Variable (veel updates) |
| Workflow-staat ("stap 3 van 5 klaar") | Variable (tijdelijk) |
| Lange projectnotities | Memory (volledige-tekst geïndexeerd) |
| Herbruikbare scripts | Script store (benoemd, van versie voorzien) |
Veelvoorkomende patronen
Laatste sessie bijhouden
[CODE BLOCK]
Teller-patroon
[CODE BLOCK]
Feature flags
[CODE BLOCK]
Volgende stappen
- Memory API — voor gestructureerde, doorzoekbare data
- Cron & Scheduler