# Chat API
SUMMARY: Asynchrone chat tussen mensen en LLM-agents — poll, antwoord, geschiedenis, ongelezen teller, bestandsuploads.

KEY CONTEXT:
Auth: Mind Key (agent side, ?role=agent) or JWT (human side, ?role=human)
Poll: GET /chat/poll (returns unread messages, marks them as read)
Reply: POST /chat/reply { content }
History: GET /chat/history?limit=50
Unread count: GET /chat/unread?role=agent (or ?role=human)
Upload: POST /chat/upload (multipart, file attachment)
Pattern: poll between tool calls, reply when human asks questions

Chat API
De Chat API maakt asynchrone berichtenuitwisseling mogelijk tussen mensen en LLM-agents.
In tegenstelling tot synchrone chat (ChatGPT-stijl) kan de mens berichten achterlaten
terwijl de agent aan het werk is — de agent pollt tussen tool-aanroepen door.
Hoe het werkt
[CODE BLOCK]
1. De mens stuurt een bericht via de web-UI (gebruikt JWT)
2. Het bericht wordt opgeslagen en gemarkeerd als ongelezen
3. De agent pollt  tussen tool-aanroepen
4. De poll retourneert alle ongelezen berichten en markeert deze als gelezen
5. De agent verwerkt het bericht en antwoordt optioneel via 
Eindpunten
GET /chat/poll
Poll voor nieuwe berichten van de mens. Retourneert ongelezen berichten en markeert
ze als gelezen. Gebruik dit tussen tool-aanroepen.
[CODE BLOCK]
Respons:
[CODE BLOCK]
POST /chat/reply
Stuur een bericht als de agent.
[CODE BLOCK]
POST /chat/send
Stuur een bericht als de mens (vereist JWT, niet Mind Key).
[CODE BLOCK]
GET /chat/history
Haal recente chatgeschiedenis op (beide rollen).
[CODE BLOCK]
GET /chat/unread
Haal het aantal ongelezen berichten op.
[CODE BLOCK]
GET /chat/status
Haal de status van de chatsessie op (laatste bericht-tijdstempels, ongelezen tellers).
[CODE BLOCK]
POST /chat/upload
Upload een bestandsbijlage voor een specifiek bericht (multipart-formulier).
[CODE BLOCK]
GET /chat/files/:messageid
Bekijk bestandsbijlagen voor een bericht.
[CODE BLOCK]
GET /chat/file/:fileid
Download een bestandsbijlage.
[CODE BLOCK]
Polling-patroon
> [!TIP]
> Poll elke 30-60 seconden tussen tool-aanroepen. Poll niet vaker —
> dat verspilt API-quota en levert geen voordeel op.
[CODE BLOCK]
Volgende stappen
- Tasks API
- Chat Polling Pattern