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).
| Operation | Aufruf | |
|---|---|---|
| Aufgaben auflisten | GET /sites/{siteId}/todos | Kostenlos |
| Aufgabe erstellen | POST /sites/{siteId}/todos | Kostenlos |
| Aufgabe ändern | PATCH /sites/{siteId}/todos/{todoId} | Kostenlos |
| Aufgabe löschen | DELETE /sites/{siteId}/todos/{todoId} | Kostenlos |
Aufgaben auflisten
/sites/{siteId}/todosKostenlosDer Aktionsplan der Website.
MCP-Tool list_todos
| Argument | Typ | Beschreibung |
|---|---|---|
siteIdim Pfad | string | Die ID. |
curl https://app.semchat.io/api/v1/sites/{siteId}/todos \
-H "Authorization: Bearer sk_live_…"{
"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
/sites/{siteId}/todosKostenlosEine 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
| Argument | Typ | Beschreibung |
|---|---|---|
siteIdim Pfad | string | Die ID. |
titleerforderlich | string | Was zu tun ist.1–500 Zeichen |
descriptionoptional | string | bis zu 4000 Zeichen |
priorityoptional | string | high, medium (Standard) oder low.high | medium | low |
categoryoptional | string | Der Bereich des Plans, zu dem sie gehört. Standard: technical.technical | content | accessibility | backlinks | competitors |
source_langoptional | string | Die Sprache, in der der Text geschrieben ist (z. B. "fr", "en"). Ohne Angabe: die Inhaltssprache der Website.2–5 Zeichen |
curl -X POST https://app.semchat.io/api/v1/sites/{siteId}/todos \
-H "Authorization: Bearer sk_live_…" \
-H "Content-Type: application/json" \
-d '{"title": "…"}'{
"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
/sites/{siteId}/todos/{todoId}KostenlosEine 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
| Argument | Typ | Beschreibung |
|---|---|---|
siteIdim Pfad | string | Die ID. |
todoIdim Pfad | string | Die ID. |
statusoptional | string | a_faire (offen), en_cours (in Arbeit), fait (erledigt) oder ignore (ignoriert).a_faire | en_cours | fait | ignore |
titleoptional | string | 1–500 Zeichen |
descriptionoptional | string | null | |
priorityoptional | string | high | medium | low |
source_langoptional | string | Die Sprache des neuen Titels bzw. der neuen Beschreibung. Wird ignoriert, wenn sich keins von beiden ändert.2–5 Zeichen |
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
/sites/{siteId}/todos/{todoId}KostenlosEine Aufgabe aus dem Aktionsplan entfernen.
MCP-Tool delete_todo
| Argument | Typ | Beschreibung |
|---|---|---|
siteIdim Pfad | string | Die ID. |
todoIdim Pfad | string | Die ID. |
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.

