DokumentationAPI-Referenz

Workspace

Der Workspace, seine Nutzung, die Suche, Skills, Tool-Einstellungen und Konnektoren.

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
Workspace abrufenGET /workspaceKostenlos
Nutzung abrufenGET /usageKostenlos
Skills auflistenGET /skillsKostenlos
Konnektoren auflistenGET /connectorsKostenlos
Workspace durchsuchenPOST /searchKostenlos
Workspace ändernPATCH /workspaceKostenlos
Skill ein- oder ausschaltenPATCH /skills/{skillId}Kostenlos
Tool-Einstellungen auflistenGET /workspace/toolsKostenlos
Tool-Einstellungen einer Website auflistenGET /sites/{siteId}/toolsKostenlos
Tool ein- oder ausschaltenPATCH /workspace/toolsKostenlos
Konnektor trennenDELETE /connectors/{provider}Kostenlos
Konnektor einer Website trennenDELETE /sites/{siteId}/connectors/{provider}Kostenlos

Workspace abrufen

GET/workspaceKostenlos

Der Workspace, sein Plan und wie viel der Credits des Zeitraums verbraucht ist.

  • Credits werden nie als Rohzahlen angezeigt, nur als Prozentsatz des Zeitraums.

MCP-Tool get_workspace

Anfrage
curl https://app.semchat.io/api/v1/workspace \
  -H "Authorization: Bearer sk_live_…"
Antwort · 200
{
  "data": {
    "id": "01995d03-8ea0-79ee-8ee3-c2eed260b3bc",
    "name": "Acme",
    "plan": {
      "id": "starter",
      "name": "Starter",
      "features": {
        "gsc": true,
        "market_data": true,
        "agents": 11,
        "backlinks": true,
        "weekly_reports": true,
        "ai_writer": true
      }
    },
    "balance": {
      "used_pct": 12.5,
      "remaining_pct": 87.5,
      "period_resets_at": "2026-11-12T13:26:58.000Z"
    },
    "settings": {
      "description": null,
      "custom_instructions": "Nous sommes une agence SEO lyonnaise.",
      "company_name": null,
      "company_website": null,
      "company_siren": null,
      "company_address": null
    }
  }
}

Nutzung abrufen

GET/usageKostenlos

Die Nutzung im aktuellen Zeitraum, in Prozent, nach Kategorie aufgeteilt.

MCP-Tool get_usage

Anfrage
curl https://app.semchat.io/api/v1/usage \
  -H "Authorization: Bearer sk_live_…"
Antwort · 200
{
  "data": {
    "period": "current",
    "used_pct": 12.5,
    "remaining_pct": 87.5,
    "by_category_pct": {
      "conversations": 2.5,
      "seo_tools": 2.5,
      "visuals": 2.5,
      "documents": 2.5,
      "site_analysis": 2.5
    }
  }
}

Skills auflisten

GET/skillsKostenlos

Die Skills, die dem Chat des Workspaces zur Verfügung stehen.

MCP-Tool list_skills

Anfrage
curl https://app.semchat.io/api/v1/skills \
  -H "Authorization: Bearer sk_live_…"
Antwort · 200
{
  "data": [
    {
      "id": "cocon-semantique",
      "name": "Topic cluster",
      "when_to_use": "Quand l'utilisateur demande : cocon sémantique.",
      "enabled": true
    },
    {
      "id": "seo-audit",
      "name": "SEO audit",
      "when_to_use": "Quand l'utilisateur demande : audit seo.",
      "enabled": true
    }
  ]
}

Konnektoren auflisten

GET/connectorsKostenlos

Auf Workspace-Ebene verbundene Tools (Search Console, GA4, Slack, Notion…).

  • Die meisten Verbindungen gelten pro Website: siehe list_site_connectors.

MCP-Tool list_connectors

Anfrage
curl https://app.semchat.io/api/v1/connectors \
  -H "Authorization: Bearer sk_live_…"

Antwortet 200 mit { "data": … }.

Workspace durchsuchen

POST/searchKostenlos

Durchsucht die Unterhaltungen, Websites, geplanten Aufgaben, Konnektoren und Skills des Workspaces nach Name, Adresse, Nachricht oder Konto, wie die Suche der App (⌘K).

  • Jede Art kommt mit more: true, wenn es weitere als die zurückgegebenen gibt.
  • Unterhaltungen werden über ihren Titel gesucht.

MCP-Tool search_workspace

ArgumentTypBeschreibung
queryerforderlichstringWonach gesucht wird, unabhängig von Akzenten und Groß- und Kleinschreibung. Leer: die neuesten jeder Art.bis zu 100 Zeichen
limitoptionalintegerHöchstens so viele pro Art (Standard und Maximum 50).≥ 1, ≤ 50
Anfrage
curl -X POST https://app.semchat.io/api/v1/search \
  -H "Authorization: Bearer sk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"query": "…"}'

Antwortet 200 mit { "data": … }.

Workspace ändern

PATCH/workspaceKostenlos

Die Einstellungen des Workspaces ändern: Name, Beschreibung, persönliche Anweisungen für den Assistenten, Firmenangaben.

  • Nur Inhaber oder Administrator (die Rolle dessen, der den Schlüssel erstellt hat): sonst 403 FORBIDDEN.
  • Nur die angegebenen Felder ändern sich; ein leerer Text (oder null) leert ein Feld. Mindestens ein Feld ist erforderlich.

MCP-Tool update_workspace

ArgumentTypBeschreibung
nameoptionalstring1–255 Zeichen
descriptionoptionalstring | null
custom_instructionsoptionalstring | nullAnweisungen, die der Assistent in jeder Unterhaltung des Workspaces befolgt.
company_nameoptionalstring | null
company_websiteoptionalstring | null
company_sirenoptionalstring | nullDie Registriernummer des Unternehmens.
company_addressoptionalstring | null
Anfrage
curl -X PATCH https://app.semchat.io/api/v1/workspace \
  -H "Authorization: Bearer sk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"name": "…"}'

Antwortet 200 mit { "data": … }.

Skill ein- oder ausschalten

PATCH/skills/{skillId}Kostenlos

Einen Skill des Workspaces für dessen Chat ein- oder ausschalten.

  • Nur Inhaber oder Administrator (die Rolle dessen, der den Schlüssel erstellt hat): sonst 403 FORBIDDEN.

MCP-Tool set_skill

ArgumentTypBeschreibung
skillIdim PfadstringDie ID.
enablederforderlichboolean
Anfrage
curl -X PATCH https://app.semchat.io/api/v1/skills/{skillId} \
  -H "Authorization: Bearer sk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"enabled": true}'

Antwortet 200 mit { "data": … }.

Tool-Einstellungen auflisten

GET/workspace/toolsKostenlos

Die Tools der Konnektoren, die der Assistent nutzen darf, jeweils für den Workspace ein- oder ausgeschaltet.

  • Ein Tool ist eingeschaltet, solange es nicht ausgeschaltet wurde. Jede Website übernimmt diese Einstellungen, außer sie legt eigene fest: siehe list_site_tool_prefs.

MCP-Tool list_tool_prefs

Anfrage
curl https://app.semchat.io/api/v1/workspace/tools \
  -H "Authorization: Bearer sk_live_…"

Antwortet 200 mit { "data": … }.

Tool-Einstellungen einer Website auflisten

GET/sites/{siteId}/toolsKostenlos

Die Tools der Konnektoren, die der Assistent in den Unterhaltungen dieser Website nutzen darf, jeweils ein- oder ausgeschaltet.

  • Die eigene Wahl der Website, wenn sie eine getroffen hat, sonst die des Workspaces.

MCP-Tool list_site_tool_prefs

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

Antwortet 200 mit { "data": … }.

Tool ein- oder ausschalten

PATCH/workspace/toolsKostenlos

Ein Tool für den Assistenten ein- oder ausschalten, für den Workspace oder für eine Website.

MCP-Tool set_tool_pref

ArgumentTypBeschreibung
tool_nameerforderlichstringDas Tool, so wie list_tool_prefs es benennt.1–64 Zeichen
enablederforderlichboolean
site_idoptionalstringNur für diese Website (Standard: der Workspace).mindestens 1 Zeichen
Anfrage
curl -X PATCH https://app.semchat.io/api/v1/workspace/tools \
  -H "Authorization: Bearer sk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"tool_name": "…", "enabled": true}'

Antwortet 200 mit { "data": … }.

Konnektor trennen

DELETE/connectors/{provider}Kostenlos

Ein auf Workspace-Ebene verbundenes Tool trennen (sein gespeicherter Zugriff wird gelöscht).

  • provider, wie list_connectors ihn anzeigt (google_search_console, google_analytics_4, notion, slack, wordpress, webflow, microsoft_clarity, bing_webmaster_tools, yandex_metrica).
  • Die eigenen Verbindungen der Websites bleiben unberührt: siehe disconnect_site_connector. Ein Tool verbinden Sie in der App.

MCP-Tool disconnect_connector

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

Antwortet 200 mit { "data": … }.

Konnektor einer Website trennen

DELETE/sites/{siteId}/connectors/{provider}Kostenlos

Ein mit dieser Website verbundenes Tool trennen (sein gespeicherter Zugriff wird gelöscht).

  • provider, wie list_site_connectors ihn anzeigt.

MCP-Tool disconnect_site_connector

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

Antwortet 200 mit { "data": … }.

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