{"title":"Chat API","slug":"chat","category":"api","summary":"Asynkron chatt mellan människor och LLM-agenter — polla, svara, historik, antal olästa, filuppladdningar.","audience":["human","llm"],"tags":["api","chat","async","messaging"],"difficulty":"intermediate","updated":"2026-06-27","word_count":217,"read_minutes":1,"llm_context":"Auth: Mind Key (agent side, ?role=agent) or JWT (human side, ?role=human)\nPoll: GET /chat/poll (returns unread messages, marks them as read)\nReply: POST /chat/reply { content }\nHistory: GET /chat/history?limit=50\nUnread count: GET /chat/unread?role=agent (or ?role=human)\nUpload: POST /chat/upload (multipart, file attachment)\nPattern: poll between tool calls, reply when human asks questions\n","lang":"sv","translated":true,"requested_lang":"sv","content_markdown":"\n# Chat API\n\nChat API möjliggör asynkron meddelandehantering mellan människor och LLM-agenter.\nTill skillnad från synkron chatt (ChatGPT-stil) kan människan lämna meddelanden\nmedan agenten arbetar — agenten pollar mellan verktygsanrop.\n\n## Hur det fungerar\n\n```\nHuman (browser) ──POST /chat/send──▶ Synapse ◀──GET /chat/poll── Agent (LLM)\n │\n └── marks messages as read on poll\n```\n\n1. Människan skickar ett meddelande via webbgränssnittet (använder JWT)\n2. Meddelandet lagras och markeras som oläst\n3. Agenten pollar `GET /chat/poll` mellan verktygsanrop\n4. Pollningen returnerar alla olästa meddelanden och markerar dem som lästa\n5. Agenten bearbetar meddelandet och svarar eventuellt via `POST /chat/reply`\n\n## Endpoints\n\n### GET /chat/poll\n\nPolla efter nya meddelanden från människan. Returnerar olästa meddelanden och\nmarkerar dem som lästa. Använd detta mellan verktygsanrop.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/chat/poll\n```\n\nSvar:\n\n```json\n{\n \"messages\": [\n {\n \"id\": \"msg_001\",\n \"role\": \"human\",\n \"content\": \"How's the deployment going?\",\n \"created_at\": \"2026-06-27T...\"\n }\n ]\n}\n```\n\n### POST /chat/reply\n\nSkicka ett meddelande som agenten.\n\n```bash\ncurl -X POST https://synapse.schaefer.zone/chat/reply \\\n -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"content\": \"Deployment is 80% done. CI is green, just waiting for Docker push.\"}'\n```\n\n### POST /chat/send\n\nSkicka ett meddelande som människa (kräver JWT, inte Mind Key).\n\n```bash\ncurl -X POST https://synapse.schaefer.zone/chat/send \\\n -H \"Authorization: Bearer YOUR_JWT\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"content\": \"Can you check the logs?\"}'\n```\n\n### GET /chat/history\n\nHämta den senaste chathistoriken (båda roller).\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/chat/history?limit=50\"\n```\n\n### GET /chat/unread\n\nHämta antal olästa meddelanden.\n\n```bash\n# Count unread messages from human (for agent)\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/chat/unread?role=agent\"\n\n# Count unread messages from agent (for human)\ncurl -H \"Authorization: Bearer YOUR_JWT\" \\\n \"https://synapse.schaefer.zone/chat/unread?role=human\"\n```\n\n### GET /chat/status\n\nHämta chattsessionens status (tidsstämplar för senaste meddelande, antal olästa).\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/chat/status\n```\n\n### POST /chat/upload\n\nLadda upp en filbilaga för ett specifikt meddelande (multipart-formulär).\n\n```bash\ncurl -X POST https://synapse.schaefer.zone/chat/upload \\\n -H \"Authorization: Bearer YOUR_JWT\" \\\n -F \"message_id=msg_001\" \\\n -F \"file=@screenshot.png\"\n```\n\n### GET /chat/files/:message_id\n\nLista filbilagor för ett meddelande.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_JWT\" \\\n https://synapse.schaefer.zone/chat/files/msg_001\n```\n\n### GET /chat/file/:file_id\n\nLadda ner en filbilaga.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_JWT\" \\\n https://synapse.schaefer.zone/chat/file/file_001 --output download.png\n```\n\n## Pollningsmönster\n\n> [!TIP]\n> Polla var 30–60 sekund mellan verktygsanrop. Polla inte oftare —\n> det slösar API-kvot och ger ingen fördel.\n\n```python\n# Pseudo-code\nwhile working:\n messages = poll_chat()\n for msg in messages:\n process_message(msg)\n reply(f\"Acknowledged: {msg.content}\")\n do_one_tool_call()\n```\n\n## Nästa steg\n\n- [Tasks API](/docs/api/tasks)\n- [Chat Polling Pattern](/docs/llm-cookbook/chat-polling-pattern)\n","content_html":"

Chat API

\n

Chat API möjliggör asynkron meddelandehantering mellan människor och LLM-agenter.\nTill skillnad från synkron chatt (ChatGPT-stil) kan människan lämna meddelanden\nmedan agenten arbetar — agenten pollar mellan verktygsanrop.

\n

Hur det fungerar

\n
Human (browser) ──POST /chat/send──▶ Synapse ◀──GET /chat/poll── Agent (LLM)\n                                     │\n                                     └── marks messages as read on poll
    \n
  1. Människan skickar ett meddelande via webbgränssnittet (använder JWT)
    2. \n
  2. Meddelandet lagras och markeras som oläst
    3. \n
  3. Agenten pollar GET /chat/poll mellan verktygsanrop
    4. \n
  4. Pollningen returnerar alla olästa meddelanden och markerar dem som lästa
    5. \n
  5. Agenten bearbetar meddelandet och svarar eventuellt via POST /chat/reply
    6. \n
\n

Endpoints

\n

GET /chat/poll

\n

Polla efter nya meddelanden från människan. Returnerar olästa meddelanden och\nmarkerar dem som lästa. Använd detta mellan verktygsanrop.

\n
curl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     https://synapse.schaefer.zone/chat/poll

Svar:

\n
{\n  "messages": [\n    {\n      "id": "msg_001",\n      "role": "human",\n      "content": "How's the deployment going?",\n      "created_at": "2026-06-27T..."\n    }\n  ]\n}

POST /chat/reply

\n

Skicka ett meddelande som agenten.

\n
curl -X POST https://synapse.schaefer.zone/chat/reply \\\n  -H "Authorization: Bearer YOUR_MIND_KEY" \\\n  -H "Content-Type: application/json" \\\n  -d '{"content": "Deployment is 80% done. CI is green, just waiting for Docker push."}'

POST /chat/send

\n

Skicka ett meddelande som människa (kräver JWT, inte Mind Key).

\n
curl -X POST https://synapse.schaefer.zone/chat/send \\\n  -H "Authorization: Bearer YOUR_JWT" \\\n  -H "Content-Type: application/json" \\\n  -d '{"content": "Can you check the logs?"}'

GET /chat/history

\n

Hämta den senaste chathistoriken (båda roller).

\n
curl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     "https://synapse.schaefer.zone/chat/history?limit=50"

GET /chat/unread

\n

Hämta antal olästa meddelanden.

\n
# Count unread messages from human (for agent)\ncurl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     "https://synapse.schaefer.zone/chat/unread?role=agent"\n\n# Count unread messages from agent (for human)\ncurl -H "Authorization: Bearer YOUR_JWT" \\\n     "https://synapse.schaefer.zone/chat/unread?role=human"

GET /chat/status

\n

Hämta chattsessionens status (tidsstämplar för senaste meddelande, antal olästa).

\n
curl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     https://synapse.schaefer.zone/chat/status

POST /chat/upload

\n

Ladda upp en filbilaga för ett specifikt meddelande (multipart-formulär).

\n
curl -X POST https://synapse.schaefer.zone/chat/upload \\\n  -H "Authorization: Bearer YOUR_JWT" \\\n  -F "message_id=msg_001" \\\n  -F "file=@screenshot.png"

GET /chat/files/:message_id

\n

Lista filbilagor för ett meddelande.

\n
curl -H "Authorization: Bearer YOUR_JWT" \\\n     https://synapse.schaefer.zone/chat/files/msg_001

GET /chat/file/:file_id

\n

Ladda ner en filbilaga.

\n
curl -H "Authorization: Bearer YOUR_JWT" \\\n     https://synapse.schaefer.zone/chat/file/file_001 --output download.png

Pollningsmönster

\n
Polla var 30–60 sekund mellan verktygsanrop. Polla inte oftare —\ndet slösar API-kvot och ger ingen fördel.
# Pseudo-code\nwhile working:\n    messages = poll_chat()\n    for msg in messages:\n        process_message(msg)\n        reply(f"Acknowledged: {msg.content}")\n    do_one_tool_call()

Nästa steg

\n\n","urls":{"html":"/docs/api/chat","text":"/docs/api/chat?format=text","json":"/docs/api/chat?format=json","llm":"/docs/api/chat?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}