# Chat API
SUMMARY: Asynkron chatt mellan människor och LLM-agenter — polla, svara, historik, antal olästa, filuppladdningar.

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
Chat API möjliggör asynkron meddelandehantering mellan människor och LLM-agenter.
Till skillnad från synkron chatt (ChatGPT-stil) kan människan lämna meddelanden
medan agenten arbetar — agenten pollar mellan verktygsanrop.
Hur det fungerar
[CODE BLOCK]
1. Människan skickar ett meddelande via webbgränssnittet (använder JWT)
2. Meddelandet lagras och markeras som oläst
3. Agenten pollar  mellan verktygsanrop
4. Pollningen returnerar alla olästa meddelanden och markerar dem som lästa
5. Agenten bearbetar meddelandet och svarar eventuellt via 
Endpoints
GET /chat/poll
Polla efter nya meddelanden från människan. Returnerar olästa meddelanden och
markerar dem som lästa. Använd detta mellan verktygsanrop.
[CODE BLOCK]
Svar:
[CODE BLOCK]
POST /chat/reply
Skicka ett meddelande som agenten.
[CODE BLOCK]
POST /chat/send
Skicka ett meddelande som människa (kräver JWT, inte Mind Key).
[CODE BLOCK]
GET /chat/history
Hämta den senaste chathistoriken (båda roller).
[CODE BLOCK]
GET /chat/unread
Hämta antal olästa meddelanden.
[CODE BLOCK]
GET /chat/status
Hämta chattsessionens status (tidsstämplar för senaste meddelande, antal olästa).
[CODE BLOCK]
POST /chat/upload
Ladda upp en filbilaga för ett specifikt meddelande (multipart-formulär).
[CODE BLOCK]
GET /chat/files/:messageid
Lista filbilagor för ett meddelande.
[CODE BLOCK]
GET /chat/file/:fileid
Ladda ner en filbilaga.
[CODE BLOCK]
Pollningsmönster
> [!TIP]
> Polla var 30–60 sekund mellan verktygsanrop. Polla inte oftare —
> det slösar API-kvot och ger ingen fördel.
[CODE BLOCK]
Nästa steg
- Tasks API
- Chat Polling Pattern