DokumentationAPI-Referenz
Unterhaltungen
Unterhaltungen im Workspace oder in einer Website, ihre Nachrichten und das Senden einer Nachricht.
Jede Operation unten ist auch ein MCP-Tool mit demselben Namen. Operationen mit Kostenlos kosten nichts; Operationen mit Kostenpflichtig verbrauchen die Credits des Workspaces, wie in der App (Was es kostet).
| Operation | Aufruf | |
|---|---|---|
| Unterhaltung ändern | PATCH /conversations/{cid} | Kostenlos |
| Unterhaltung löschen | DELETE /conversations/{cid} | Kostenlos |
| Unterhaltungen auflisten | GET /conversations | Kostenlos |
| Unterhaltung erstellen | POST /conversations | Kostenlos |
| Unterhaltung abrufen | GET /conversations/{cid} | Kostenlos |
| Nachrichten auflisten | GET /conversations/{cid}/messages | Kostenlos |
| Nachricht senden | POST /conversations/{cid}/messages | Kostenpflichtig |
| Dokumente einer Unterhaltung auflisten | GET /conversations/{cid}/documents | Kostenlos |
| Unterhaltungen einer Website auflisten | GET /sites/{siteId}/conversations | Kostenlos |
| Unterhaltung in einer Website erstellen | POST /sites/{siteId}/conversations | Kostenlos |
| Unterhaltung einer Website abrufen | GET /sites/{siteId}/conversations/{cid} | Kostenlos |
| Nachrichten einer Website-Unterhaltung auflisten | GET /sites/{siteId}/conversations/{cid}/messages | Kostenlos |
| Nachricht in einer Website senden | POST /sites/{siteId}/conversations/{cid}/messages | Kostenpflichtig |
Unterhaltung ändern
/conversations/{cid}KostenlosEine Unterhaltung umbenennen oder ihren Stern setzen oder entfernen.
- Wirkt auf jede Unterhaltung des Workspaces, auch auf die einer Website (ihre cid genügt), wie in der App.
- Nur die angegebenen Felder werden geändert. Antwortet mit der Unterhaltung.
MCP-Tool update_conversation
| Argument | Typ | Beschreibung |
|---|---|---|
cidim Pfad | string | Die ID. |
titleoptional | string | Die Unterhaltung umbenennen.1–500 Zeichen |
starredoptional | boolean | true markiert sie mit einem Stern (starred_at = jetzt), false entfernt ihn. |
curl -X PATCH https://app.semchat.io/api/v1/conversations/{cid} \
-H "Authorization: Bearer sk_live_…" \
-H "Content-Type: application/json" \
-d '{"title": "…"}'Antwortet 200 mit { "data": … }.
Unterhaltung löschen
/conversations/{cid}KostenlosEine Unterhaltung löschen.
- Wirkt auf jede Unterhaltung des Workspaces, auch auf die einer Website (ihre cid genügt), wie in der App.
- Weiches Löschen, wie in der App: Sie verschwindet aus den Listen und antwortet 404; ihre Nachrichten und die daraus gespeicherten Daten bleiben erhalten.
MCP-Tool delete_conversation
| Argument | Typ | Beschreibung |
|---|---|---|
cidim Pfad | string | Die ID. |
curl -X DELETE https://app.semchat.io/api/v1/conversations/{cid} \
-H "Authorization: Bearer sk_live_…"Antwortet 200 mit { "data": … }.
Unterhaltungen auflisten
/conversationsKostenlosDie Unterhaltungen des Workspaces (an keine Website gebunden).
MCP-Tool list_conversations
curl https://app.semchat.io/api/v1/conversations \
-H "Authorization: Bearer sk_live_…"{
"data": [
{
"id": "01a163c9-4920-773f-89fb-75ff608e07fe",
"title": "Audit complet d'alpha",
"site_id": null,
"message_count": 2,
"starred_at": "2026-10-22T13:31:58.000Z",
"last_message_at": "2026-10-22T13:26:58.000Z",
"created_at": "2026-10-22T13:24:58.000Z",
"updated_at": "2026-10-22T13:26:58.000Z"
},
{
"id": "01a15ea2-ed20-7a5d-a415-afcd68358a91",
"title": "Idées de contenu",
"site_id": null,
"message_count": 2,
"starred_at": "2026-10-21T13:31:58.000Z",
"last_message_at": "2026-10-21T13:26:58.000Z",
"created_at": "2026-10-21T13:24:58.000Z",
"updated_at": "2026-10-21T13:26:58.000Z"
}
]
}Unterhaltung erstellen
/conversationsKostenlosEine Unterhaltung im Workspace beginnen.
MCP-Tool create_conversation
| Argument | Typ | Beschreibung |
|---|---|---|
titleoptional | string | Ihr Titel (optional).bis zu 500 Zeichen |
curl -X POST https://app.semchat.io/api/v1/conversations \
-H "Authorization: Bearer sk_live_…" \
-H "Content-Type: application/json" \
-d '{"title": "…"}'Antwortet 201 mit { "data": … }.
Unterhaltung abrufen
/conversations/{cid}KostenlosEine Unterhaltung des Workspaces (auch die einer Website).
MCP-Tool get_conversation
| Argument | Typ | Beschreibung |
|---|---|---|
cidim Pfad | string | Die ID. |
curl https://app.semchat.io/api/v1/conversations/{cid} \
-H "Authorization: Bearer sk_live_…"{
"data": {
"id": "01a163c9-4920-773f-89fb-75ff608e07fe",
"title": "Audit complet d'alpha",
"site_id": null,
"message_count": 2,
"starred_at": "2026-10-22T13:31:58.000Z",
"last_message_at": "2026-10-22T13:26:58.000Z",
"created_at": "2026-10-22T13:24:58.000Z",
"updated_at": "2026-10-22T13:26:58.000Z"
}
}Nachrichten auflisten
/conversations/{cid}/messagesKostenlosDie Nachrichten einer Workspace-Unterhaltung, die älteste zuerst (Text, Tool-Aufrufe und Ergebnisse, Charts, Dokumente).
MCP-Tool list_messages
| Argument | Typ | Beschreibung |
|---|---|---|
cidim Pfad | string | Die ID. |
curl https://app.semchat.io/api/v1/conversations/{cid}/messages \
-H "Authorization: Bearer sk_live_…"{
"data": [
{
"id": "01a15456-3520-7803-9dfd-670569df332f",
"role": "user",
"content": "C'est quoi le SEO ?",
"parts": [
"…"
],
"created_at": "2026-10-19T13:24:58.272Z"
},
{
"id": "01a15456-aa50-78f0-8c72-120a580ca098",
"role": "assistant",
"content": "Le référencement naturel.",
"parts": [
"…",
"…"
],
"created_at": "2026-10-19T13:25:28.272Z"
}
]
}Nachricht senden
/conversations/{cid}/messagesKostenpflichtigEine Nachricht senden: Der Assistent antwortet und nutzt dabei seine Tools (Keyword-Daten, Crawl, Wettbewerber…) wie in der App.
- Anhänge werden wie in der App gespeichert (jedes Mitglied des Workspaces; ein nicht unterstützter Typ oder eine Datei über 20 MB ergibt INVALID_INPUT) und erreichen den Assistenten mit der Nachricht. Eine Anfrage hat höchstens 25 MB: etwa 18 MB an Dateien nach der Base64-Kodierung.
- Die API streamt die Antwort als Server-Sent Events („UI message stream“ des Vercel AI SDK); sobald sie fertig ist, lesen Sie sie vollständig über die Nachrichtenliste. Über MCP wartet das Tool bis zum Ende und gibt die Antwort zurück.
- In Credits abgerechnet, genau wie eine Chat-Runde in der App.
MCP-Tool send_message
| Argument | Typ | Beschreibung |
|---|---|---|
cidim Pfad | string | Die ID. |
messageerforderlich | string | Die Nachricht des Nutzers.mindestens 1 Zeichen |
attachmentsoptional | array | An die Nachricht angehängte Dateien, wie in der App (dieselben Typen, jeweils höchstens 20 MB). |
streamoptional | boolean | Aus Kompatibilitätsgründen akzeptiert; die Antwort der API wird immer gestreamt. |
curl -X POST https://app.semchat.io/api/v1/conversations/{cid}/messages \
-H "Authorization: Bearer sk_live_…" \
-H "Content-Type: application/json" \
-d '{"message": "…"}'Die Antwort kommt als Stream (Server-Sent Events); sobald sie fertig ist, lesen Sie sie vollständig über die Nachrichtenliste. Über MCP wartet das Tool bis zum Ende und gibt die Antwort zurück.
Dokumente einer Unterhaltung auflisten
/conversations/{cid}/documentsKostenlosDie in einer Workspace-Unterhaltung geschriebenen Dokumente.
MCP-Tool list_conversation_documents
| Argument | Typ | Beschreibung |
|---|---|---|
cidim Pfad | string | Die ID. |
curl https://app.semchat.io/api/v1/conversations/{cid}/documents \
-H "Authorization: Bearer sk_live_…"Antwortet 200 mit { "data": … }.
Unterhaltungen einer Website auflisten
/sites/{siteId}/conversationsKostenlosDie Unterhaltungen einer Website.
MCP-Tool list_site_conversations
| Argument | Typ | Beschreibung |
|---|---|---|
siteIdim Pfad | string | Die ID. |
curl https://app.semchat.io/api/v1/sites/{siteId}/conversations \
-H "Authorization: Bearer sk_live_…"Antwortet 200 mit { "data": … }.
Unterhaltung in einer Website erstellen
/sites/{siteId}/conversationsKostenlosEine Unterhaltung in einer Website beginnen: Der Assistent kennt diese Website.
MCP-Tool create_site_conversation
| Argument | Typ | Beschreibung |
|---|---|---|
siteIdim Pfad | string | Die ID. |
titleoptional | string | Ihr Titel (optional).bis zu 500 Zeichen |
curl -X POST https://app.semchat.io/api/v1/sites/{siteId}/conversations \
-H "Authorization: Bearer sk_live_…" \
-H "Content-Type: application/json" \
-d '{"title": "…"}'Antwortet 201 mit { "data": … }.
Unterhaltung einer Website abrufen
/sites/{siteId}/conversations/{cid}KostenlosEine der Unterhaltungen einer Website.
MCP-Tool get_site_conversation
| Argument | Typ | Beschreibung |
|---|---|---|
siteIdim Pfad | string | Die ID. |
cidim Pfad | string | Die ID. |
curl https://app.semchat.io/api/v1/sites/{siteId}/conversations/{cid} \
-H "Authorization: Bearer sk_live_…"Antwortet 200 mit { "data": … }.
Nachrichten einer Website-Unterhaltung auflisten
/sites/{siteId}/conversations/{cid}/messagesKostenlosDie Nachrichten einer Website-Unterhaltung, die älteste zuerst.
MCP-Tool list_site_messages
| Argument | Typ | Beschreibung |
|---|---|---|
siteIdim Pfad | string | Die ID. |
cidim Pfad | string | Die ID. |
curl https://app.semchat.io/api/v1/sites/{siteId}/conversations/{cid}/messages \
-H "Authorization: Bearer sk_live_…"Antwortet 200 mit { "data": … }.
Nachricht in einer Website senden
/sites/{siteId}/conversations/{cid}/messagesKostenpflichtigEine Nachricht in einer Website-Unterhaltung senden: Der Assistent antwortet mit Blick auf diese Website.
- Anhänge werden wie in der App gespeichert (jedes Mitglied des Workspaces; ein nicht unterstützter Typ oder eine Datei über 20 MB ergibt INVALID_INPUT) und erreichen den Assistenten mit der Nachricht. Eine Anfrage hat höchstens 25 MB: etwa 18 MB an Dateien nach der Base64-Kodierung.
- Die API streamt die Antwort als Server-Sent Events („UI message stream“ des Vercel AI SDK); sobald sie fertig ist, lesen Sie sie vollständig über die Nachrichtenliste. Über MCP wartet das Tool bis zum Ende und gibt die Antwort zurück.
- In Credits abgerechnet, genau wie eine Chat-Runde in der App.
MCP-Tool send_site_message
| Argument | Typ | Beschreibung |
|---|---|---|
siteIdim Pfad | string | Die ID. |
cidim Pfad | string | Die ID. |
messageerforderlich | string | Die Nachricht des Nutzers.mindestens 1 Zeichen |
attachmentsoptional | array | An die Nachricht angehängte Dateien, wie in der App (dieselben Typen, jeweils höchstens 20 MB). |
streamoptional | boolean | Aus Kompatibilitätsgründen akzeptiert; die Antwort der API wird immer gestreamt. |
curl -X POST https://app.semchat.io/api/v1/sites/{siteId}/conversations/{cid}/messages \
-H "Authorization: Bearer sk_live_…" \
-H "Content-Type: application/json" \
-d '{"message": "…"}'Die Antwort kommt als Stream (Server-Sent Events); sobald sie fertig ist, lesen Sie sie vollständig über die Nachrichtenliste. Über MCP wartet das Tool bis zum Ende und gibt die Antwort zurück.
Keine Antwort auf Ihre Frage gefunden? Schreiben Sie uns.

