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

OperationAufruf
Geplante Aufgaben auflistenGET /tasksKostenlos
Geplante Aufgabe abrufenGET /tasks/{taskId}Kostenlos
Geplante Aufgabe erstellenPOST /tasksKostenlos
Geplante Aufgabe ändernPATCH /tasks/{taskId}Kostenlos
Geplante Aufgabe löschenDELETE /tasks/{taskId}Kostenlos
Geplante Aufgabe jetzt startenPOST /tasks/{taskId}/runKostenpflichtig
Läufe einer geplanten Aufgabe auflistenGET /tasks/{taskId}/runsKostenlos

Geplante Aufgaben auflisten

GET/tasksKostenlos

Alle geplanten Aufgaben des Workspaces: ihre Nachricht, ihr Zeitplan, ihr Zustand, ihr nächster und ihr letzter Lauf.

MCP-Tool list_scheduled_tasks

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

Antwortet 200 mit { "data": … }.

Geplante Aufgabe abrufen

GET/tasks/{taskId}Kostenlos

Eine geplante Aufgabe.

MCP-Tool get_scheduled_task

ArgumentTypBeschreibung
taskIdim PfadstringDie ID.
Anfrage
curl https://app.semchat.io/api/v1/tasks/{taskId} \
  -H "Authorization: Bearer sk_live_…"

Antwortet 200 mit { "data": … }.

Geplante Aufgabe erstellen

POST/tasksKostenlos

Eine 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

ArgumentTypBeschreibung
nameerforderlichstringDer Name der Aufgabe, wie die Liste ihn zeigt.1–120 Zeichen
prompterforderlichstringDie 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
scheduleerforderlichstring | nullWann 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).
timezoneerforderlichstringDie Zeitzone ihrer Uhrzeiten, z. B. "Europe/Paris".
site_idoptionalstring | nullDie Website, um die es geht, für die Liste (null: keine). Standard: die erste Website, die ihre Nachricht nennt.
Anfrage
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

PATCH/tasks/{taskId}Kostenlos

Eine 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

ArgumentTypBeschreibung
taskIdim PfadstringDie ID.
nameoptionalstringDer Name der Aufgabe, wie die Liste ihn zeigt.1–120 Zeichen
promptoptionalstringDie 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
scheduleoptionalstring | nullWann 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).
timezoneoptionalstringDie Zeitzone ihrer Uhrzeiten, z. B. "Europe/Paris".
site_idoptionalstring | nullDie Website, um die es geht, für die Liste (null: keine). Standard: die erste Website, die ihre Nachricht nennt.
statusoptionalstring"paused": Sie läuft nicht mehr; "active": Sie läuft wieder (ihr Fehlerzähler wird zurückgesetzt).active | paused
Anfrage
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

DELETE/tasks/{taskId}Kostenlos

Eine 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

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

Antwortet 204 mit { "data": … }.

Geplante Aufgabe jetzt starten

POST/tasks/{taskId}/runKostenpflichtig

Eine 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

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

GET/tasks/{taskId}/runsKostenlos

Die letzten Läufe einer geplanten Aufgabe, der neueste zuerst: jeweils Zustand, Unterhaltung, Titel und Zusammenfassung.

MCP-Tool list_scheduled_task_runs

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

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