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).

OperationAufruf
Unterhaltung ändernPATCH /conversations/{cid}Kostenlos
Unterhaltung löschenDELETE /conversations/{cid}Kostenlos
Unterhaltungen auflistenGET /conversationsKostenlos
Unterhaltung erstellenPOST /conversationsKostenlos
Unterhaltung abrufenGET /conversations/{cid}Kostenlos
Nachrichten auflistenGET /conversations/{cid}/messagesKostenlos
Nachricht sendenPOST /conversations/{cid}/messagesKostenpflichtig
Dokumente einer Unterhaltung auflistenGET /conversations/{cid}/documentsKostenlos
Unterhaltungen einer Website auflistenGET /sites/{siteId}/conversationsKostenlos
Unterhaltung in einer Website erstellenPOST /sites/{siteId}/conversationsKostenlos
Unterhaltung einer Website abrufenGET /sites/{siteId}/conversations/{cid}Kostenlos
Nachrichten einer Website-Unterhaltung auflistenGET /sites/{siteId}/conversations/{cid}/messagesKostenlos
Nachricht in einer Website sendenPOST /sites/{siteId}/conversations/{cid}/messagesKostenpflichtig

Unterhaltung ändern

PATCH/conversations/{cid}Kostenlos

Eine 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

ArgumentTypBeschreibung
cidim PfadstringDie ID.
titleoptionalstringDie Unterhaltung umbenennen.1–500 Zeichen
starredoptionalbooleantrue markiert sie mit einem Stern (starred_at = jetzt), false entfernt ihn.
Anfrage
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

DELETE/conversations/{cid}Kostenlos

Eine 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

ArgumentTypBeschreibung
cidim PfadstringDie ID.
Anfrage
curl -X DELETE https://app.semchat.io/api/v1/conversations/{cid} \
  -H "Authorization: Bearer sk_live_…"

Antwortet 200 mit { "data": … }.

Unterhaltungen auflisten

GET/conversationsKostenlos

Die Unterhaltungen des Workspaces (an keine Website gebunden).

MCP-Tool list_conversations

Anfrage
curl https://app.semchat.io/api/v1/conversations \
  -H "Authorization: Bearer sk_live_…"
Antwort · 200
{
  "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

POST/conversationsKostenlos

Eine Unterhaltung im Workspace beginnen.

MCP-Tool create_conversation

ArgumentTypBeschreibung
titleoptionalstringIhr Titel (optional).bis zu 500 Zeichen
Anfrage
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

GET/conversations/{cid}Kostenlos

Eine Unterhaltung des Workspaces (auch die einer Website).

MCP-Tool get_conversation

ArgumentTypBeschreibung
cidim PfadstringDie ID.
Anfrage
curl https://app.semchat.io/api/v1/conversations/{cid} \
  -H "Authorization: Bearer sk_live_…"
Antwort · 200
{
  "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

GET/conversations/{cid}/messagesKostenlos

Die Nachrichten einer Workspace-Unterhaltung, die älteste zuerst (Text, Tool-Aufrufe und Ergebnisse, Charts, Dokumente).

MCP-Tool list_messages

ArgumentTypBeschreibung
cidim PfadstringDie ID.
Anfrage
curl https://app.semchat.io/api/v1/conversations/{cid}/messages \
  -H "Authorization: Bearer sk_live_…"
Antwort · 200
{
  "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

POST/conversations/{cid}/messagesKostenpflichtig

Eine 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

ArgumentTypBeschreibung
cidim PfadstringDie ID.
messageerforderlichstringDie Nachricht des Nutzers.mindestens 1 Zeichen
attachmentsoptionalarrayAn die Nachricht angehängte Dateien, wie in der App (dieselben Typen, jeweils höchstens 20 MB).
streamoptionalbooleanAus Kompatibilitätsgründen akzeptiert; die Antwort der API wird immer gestreamt.
Anfrage
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

GET/conversations/{cid}/documentsKostenlos

Die in einer Workspace-Unterhaltung geschriebenen Dokumente.

MCP-Tool list_conversation_documents

ArgumentTypBeschreibung
cidim PfadstringDie ID.
Anfrage
curl https://app.semchat.io/api/v1/conversations/{cid}/documents \
  -H "Authorization: Bearer sk_live_…"

Antwortet 200 mit { "data": … }.

Unterhaltungen einer Website auflisten

GET/sites/{siteId}/conversationsKostenlos

Die Unterhaltungen einer Website.

MCP-Tool list_site_conversations

ArgumentTypBeschreibung
siteIdim PfadstringDie ID.
Anfrage
curl https://app.semchat.io/api/v1/sites/{siteId}/conversations \
  -H "Authorization: Bearer sk_live_…"

Antwortet 200 mit { "data": … }.

Unterhaltung in einer Website erstellen

POST/sites/{siteId}/conversationsKostenlos

Eine Unterhaltung in einer Website beginnen: Der Assistent kennt diese Website.

MCP-Tool create_site_conversation

ArgumentTypBeschreibung
siteIdim PfadstringDie ID.
titleoptionalstringIhr Titel (optional).bis zu 500 Zeichen
Anfrage
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

GET/sites/{siteId}/conversations/{cid}Kostenlos

Eine der Unterhaltungen einer Website.

MCP-Tool get_site_conversation

ArgumentTypBeschreibung
siteIdim PfadstringDie ID.
cidim PfadstringDie ID.
Anfrage
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

GET/sites/{siteId}/conversations/{cid}/messagesKostenlos

Die Nachrichten einer Website-Unterhaltung, die älteste zuerst.

MCP-Tool list_site_messages

ArgumentTypBeschreibung
siteIdim PfadstringDie ID.
cidim PfadstringDie ID.
Anfrage
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

POST/sites/{siteId}/conversations/{cid}/messagesKostenpflichtig

Eine 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

ArgumentTypBeschreibung
siteIdim PfadstringDie ID.
cidim PfadstringDie ID.
messageerforderlichstringDie Nachricht des Nutzers.mindestens 1 Zeichen
attachmentsoptionalarrayAn die Nachricht angehängte Dateien, wie in der App (dieselben Typen, jeweils höchstens 20 MB).
streamoptionalbooleanAus Kompatibilitätsgründen akzeptiert; die Antwort der API wird immer gestreamt.
Anfrage
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.

Bereit, Ihrer Website Aufschwung zu geben?

Stellen Sie Ihre erste Frage - semchat antwortet in Sekunden mit einem klaren Aktionsplan.

Kostenlos · ohne Anmeldung · in 5 Sekunden