DokumentationAPI-Referenz
Geplante Aufgaben
Geplante Aufgaben: erstellen, ändern, sofort starten und ihre Läufe lesen.
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 | |
|---|---|---|
| Geplante Aufgaben auflisten | GET /tasks | Kostenlos |
| Geplante Aufgabe abrufen | GET /tasks/{taskId} | Kostenlos |
| Geplante Aufgabe erstellen | POST /tasks | Kostenlos |
| Geplante Aufgabe ändern | PATCH /tasks/{taskId} | Kostenlos |
| Geplante Aufgabe löschen | DELETE /tasks/{taskId} | Kostenlos |
| Geplante Aufgabe jetzt starten | POST /tasks/{taskId}/run | Kostenpflichtig |
| Läufe einer geplanten Aufgabe auflisten | GET /tasks/{taskId}/runs | Kostenlos |
Geplante Aufgaben auflisten
/tasksKostenlosAlle geplanten Aufgaben des Workspaces: ihre Nachricht, ihr Zeitplan, ihr Zustand, ihr nächster und ihr letzter Lauf.
MCP-Tool list_scheduled_tasks
curl https://app.semchat.io/api/v1/tasks \
-H "Authorization: Bearer sk_live_…"Antwortet 200 mit { "data": … }.
Geplante Aufgabe abrufen
/tasks/{taskId}KostenlosEine geplante Aufgabe.
MCP-Tool get_scheduled_task
| Argument | Typ | Beschreibung |
|---|---|---|
taskIdim Pfad | string | Die ID. |
curl https://app.semchat.io/api/v1/tasks/{taskId} \
-H "Authorization: Bearer sk_live_…"Antwortet 200 mit { "data": … }.
Geplante Aufgabe erstellen
/tasksKostenlosEine geplante Aufgabe erstellen: eine Nachricht, die der Assistent nach Zeitplan von selbst ausführt, wie unter Aufgaben in der App.
- Sie ist von Anfang an aktiv: Ihr erster Lauf findet zum nächsten Zeitpunkt des Zeitplans statt.
- Jeder Lauf ist eine Unterhaltung des Workspaces und wird wie eine Chat-Nachricht abgerechnet. Eine Aktion außerhalb von semchat (veröffentlichen, posten), die ihre Nachricht verlangt, wird sofort ausgeführt, wie in jedem Chat.
MCP-Tool create_scheduled_task
| Argument | Typ | Beschreibung |
|---|---|---|
nameerforderlich | string | Der Name der Aufgabe, wie die Liste ihn zeigt.1–120 Zeichen |
prompterforderlich | string | Die Nachricht, die der Assistent jedes Mal ausführt, geschrieben wie im Chat. Sie kann eine Website nennen („/site:example.com“: ihre Daten und Konnektoren), einen Skill („/<skill-id>“), eine E-Mail-Adresse („/email:paul@example.com“), einen Discord-Kanal („/discord:<id>“), ein Slack- oder Notion-Konto („/slack:<id>“, „/notion:<id>“).1–8000 Zeichen |
scheduleerforderlich | string | null | Wann sie läuft: { kind: "daily", time: "08:00" }, { kind: "weekly", days: ["mon", "thu"], time: "08:00" }, { kind: "monthly", day: 1, time: "08:00" } (in einem kürzeren Monat: dessen letzter Tag) oder { kind: "hourly", every: 6 } (1, 2, 3, 4, 6, 8 oder 12). |
timezoneerforderlich | string | Die Zeitzone ihrer Uhrzeiten, z. B. "Europe/Paris". |
site_idoptional | string | null | Die Website, um die es geht, für die Liste (null: keine). Standard: die erste Website, die ihre Nachricht nennt. |
curl -X POST https://app.semchat.io/api/v1/tasks \
-H "Authorization: Bearer sk_live_…" \
-H "Content-Type: application/json" \
-d '{"name": "…", "prompt": "…", "schedule": "…", "timezone": "…"}'Antwortet 201 mit { "data": … }.
Geplante Aufgabe ändern
/tasks/{taskId}KostenlosEine geplante Aufgabe ändern: Name, Nachricht, Zeitplan, Zeitzone oder Website, oder sie pausieren und fortsetzen (status).
- Nur ihr Autor, der Inhaber des Workspaces oder ein Administrator kann eine Aufgabe ändern, starten oder löschen: sonst 403 FORBIDDEN.
- Nur die angegebenen Felder ändern sich; mindestens eins ist erforderlich. Ein neuer Zeitplan, eine neue Zeitzone oder ein Fortsetzen verschiebt den nächsten Lauf auf den nächsten Zeitpunkt des Zeitplans ab jetzt.
MCP-Tool update_scheduled_task
| Argument | Typ | Beschreibung |
|---|---|---|
taskIdim Pfad | string | Die ID. |
nameoptional | string | Der Name der Aufgabe, wie die Liste ihn zeigt.1–120 Zeichen |
promptoptional | string | Die Nachricht, die der Assistent jedes Mal ausführt, geschrieben wie im Chat. Sie kann eine Website nennen („/site:example.com“: ihre Daten und Konnektoren), einen Skill („/<skill-id>“), eine E-Mail-Adresse („/email:paul@example.com“), einen Discord-Kanal („/discord:<id>“), ein Slack- oder Notion-Konto („/slack:<id>“, „/notion:<id>“).1–8000 Zeichen |
scheduleoptional | string | null | Wann sie läuft: { kind: "daily", time: "08:00" }, { kind: "weekly", days: ["mon", "thu"], time: "08:00" }, { kind: "monthly", day: 1, time: "08:00" } (in einem kürzeren Monat: dessen letzter Tag) oder { kind: "hourly", every: 6 } (1, 2, 3, 4, 6, 8 oder 12). |
timezoneoptional | string | Die Zeitzone ihrer Uhrzeiten, z. B. "Europe/Paris". |
site_idoptional | string | null | Die Website, um die es geht, für die Liste (null: keine). Standard: die erste Website, die ihre Nachricht nennt. |
statusoptional | string | "paused": Sie läuft nicht mehr; "active": Sie läuft wieder (ihr Fehlerzähler wird zurückgesetzt).active | paused |
curl -X PATCH https://app.semchat.io/api/v1/tasks/{taskId} \
-H "Authorization: Bearer sk_live_…" \
-H "Content-Type: application/json" \
-d '{"name": "…"}'Antwortet 200 mit { "data": … }.
Geplante Aufgabe löschen
/tasks/{taskId}KostenlosEine geplante Aufgabe löschen. Ihre bisherigen Läufe und deren Unterhaltungen bleiben erhalten.
- Nur ihr Autor, der Inhaber des Workspaces oder ein Administrator kann eine Aufgabe ändern, starten oder löschen: sonst 403 FORBIDDEN.
MCP-Tool delete_scheduled_task
| Argument | Typ | Beschreibung |
|---|---|---|
taskIdim Pfad | string | Die ID. |
curl -X DELETE https://app.semchat.io/api/v1/tasks/{taskId} \
-H "Authorization: Bearer sk_live_…"Antwortet 204 mit { "data": … }.
Geplante Aufgabe jetzt starten
/tasks/{taskId}/runKostenpflichtigEine geplante Aufgabe jetzt starten, wie „Jetzt starten“ in der App: ein einzelner Lauf, ihr Zeitplan bleibt unverändert.
- Nur ihr Autor, der Inhaber des Workspaces oder ein Administrator kann eine Aufgabe ändern, starten oder löschen: sonst 403 FORBIDDEN.
- Antwortet sofort mit der ID des Laufs; der Lauf geht im Hintergrund weiter: Lesen Sie list_scheduled_task_runs für seine Unterhaltung und seine Zusammenfassung.
- 409 CONFLICT, solange einer ihrer Läufe noch läuft; 402 INSUFFICIENT_TOKENS ohne Credits.
MCP-Tool run_scheduled_task
| Argument | Typ | Beschreibung |
|---|---|---|
taskIdim Pfad | string | Die ID. |
curl -X POST https://app.semchat.io/api/v1/tasks/{taskId}/run \
-H "Authorization: Bearer sk_live_…"Antwortet 202 mit { "data": … }.
Läufe einer geplanten Aufgabe auflisten
/tasks/{taskId}/runsKostenlosDie letzten Läufe einer geplanten Aufgabe, der neueste zuerst: jeweils Zustand, Unterhaltung, Titel und Zusammenfassung.
MCP-Tool list_scheduled_task_runs
| Argument | Typ | Beschreibung |
|---|---|---|
taskIdim Pfad | string | Die ID. |
curl https://app.semchat.io/api/v1/tasks/{taskId}/runs \
-H "Authorization: Bearer sk_live_…"Antwortet 200 mit { "data": … }.
Keine Antwort auf Ihre Frage gefunden? Schreiben Sie uns.

