DokumentationAPI-Referenz

Aktionsplan

Der Aktionsplan einer Website: Aufgaben auflisten, hinzufügen, ändern und löschen.

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
Aufgaben auflistenGET /sites/{siteId}/todosKostenlos
Aufgabe erstellenPOST /sites/{siteId}/todosKostenlos
Aufgabe ändernPATCH /sites/{siteId}/todos/{todoId}Kostenlos
Aufgabe löschenDELETE /sites/{siteId}/todos/{todoId}Kostenlos

Aufgaben auflisten

GET/sites/{siteId}/todosKostenlos

Der Aktionsplan der Website.

MCP-Tool list_todos

ArgumentTypBeschreibung
siteIdim PfadstringDie ID.
Anfrage
curl https://app.semchat.io/api/v1/sites/{siteId}/todos \
  -H "Authorization: Bearer sk_live_…"
Antwort · 200
{
  "data": [
    {
      "id": "01a15ea4-c1e0-7c64-bc14-c499bd6f1b83",
      "title": "Corriger le point technical n°1",
      "description": "Corriger le point technical n°1 - détail.",
      "category": "technical",
      "priority": "high",
      "status": "a_faire",
      "source": "audit_auto",
      "created_at": "2026-10-21T13:26:58.000Z"
    },
    {
      "id": "01a15ea4-c1e0-74b9-8ca0-f4c3410b0f0f",
      "title": "Corriger le point technical n°2",
      "description": "Corriger le point technical n°2 - détail.",
      "category": "technical",
      "priority": "medium",
      "status": "fait",
      "source": "audit_auto",
      "created_at": "2026-10-21T13:27:58.000Z"
    }
  ]
}

Aufgabe erstellen

POST/sites/{siteId}/todosKostenlos

Eine Aufgabe zum Aktionsplan der Website hinzufügen.

  • Als manuelle Aufgabe (source manuel) mit dem Status offen (status a_faire) angelegt. Antwortet mit der Aufgabe.

MCP-Tool create_todo

ArgumentTypBeschreibung
siteIdim PfadstringDie ID.
titleerforderlichstringWas zu tun ist.1–500 Zeichen
descriptionoptionalstringbis zu 4000 Zeichen
priorityoptionalstringhigh, medium (Standard) oder low.high | medium | low
categoryoptionalstringDer Bereich des Plans, zu dem sie gehört. Standard: technical.technical | content | accessibility | backlinks | competitors
source_langoptionalstringDie Sprache, in der der Text geschrieben ist (z. B. "fr", "en"). Ohne Angabe: die Inhaltssprache der Website.2–5 Zeichen
Anfrage
curl -X POST https://app.semchat.io/api/v1/sites/{siteId}/todos \
  -H "Authorization: Bearer sk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"title": "…"}'
Antwort · 201
{
  "data": {
    "id": "01a168f1-9dac-7584-b809-fc4ed6d1cffe",
    "title": "Add alt text to the gallery images",
    "description": null,
    "category": "technical",
    "priority": "high",
    "status": "a_faire",
    "source": "manuel",
    "created_at": "2026-10-23T13:27:07.000Z"
  }
}

Aufgabe ändern

PATCH/sites/{siteId}/todos/{todoId}Kostenlos

Eine Aufgabe des Aktionsplans ändern: Status (offen, in Arbeit, erledigt, ignoriert), Titel, Beschreibung oder Priorität.

  • Antwortet mit der Aufgabe in ihrem neuen Stand.
  • Text wird so zurückgegeben, wie er gespeichert ist, in der Sprache, in der er geschrieben wurde (source_lang; null = die Inhaltssprache der Website). Die App übersetzt ihn bei der Anzeige, die API nicht.

MCP-Tool update_todo

ArgumentTypBeschreibung
siteIdim PfadstringDie ID.
todoIdim PfadstringDie ID.
statusoptionalstringa_faire (offen), en_cours (in Arbeit), fait (erledigt) oder ignore (ignoriert).a_faire | en_cours | fait | ignore
titleoptionalstring1–500 Zeichen
descriptionoptionalstring | null
priorityoptionalstringhigh | medium | low
source_langoptionalstringDie Sprache des neuen Titels bzw. der neuen Beschreibung. Wird ignoriert, wenn sich keins von beiden ändert.2–5 Zeichen
Anfrage
curl -X PATCH https://app.semchat.io/api/v1/sites/{siteId}/todos/{todoId} \
  -H "Authorization: Bearer sk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"status": "a_faire"}'

Antwortet 200 mit { "data": … }.

Aufgabe löschen

DELETE/sites/{siteId}/todos/{todoId}Kostenlos

Eine Aufgabe aus dem Aktionsplan entfernen.

MCP-Tool delete_todo

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

Antwortet 204 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