Basis-URL
API-Key-Scopes
Jeder Endpoint nutzt denselben Scope.
Lege einen Workspace-API-Key unter Einstellungen > Workspace > Produkte > API an. Ein persönlicher API-Key kann die Scheduled Tasks API enthalten, wenn dein Admin sie erlaubt. Mehr dazu findest du unter Persönliche API-Keys.
Ein Workspace-Key läuft als sein Service-Account. Ein persönlicher Key läuft als das Mitglied, dem er gehört. Scheduled Tasks müssen im Workspace aktiv sein, und dieser Besitzer braucht Zugriff. Allgemeiner Zugriff schließt den Besitzer ein. Mitgliederzugriff gilt nur, wenn der Besitzer oder eine seiner Gruppen enthalten ist.
Jede Aufgabe gehört dem Besitzer, der sie erstellt hat. Das ist das Mitglied eines persönlichen Keys oder der Service-Account eines Workspace-Keys. Der Key sieht und ändert die Aufgaben dieses Besitzers. Ein persönlicher Key sieht auch Aufgaben, die das Mitglied im Produkt angelegt hat. Pro Besitzer sind 10 Aufgaben im Workspace möglich. Die elfte Erstellung liefert
400 mit der Message AUTOMATION_LIMIT_REACHED.
Hat ein Service-Account keinen gültigen Key mit AUTOMATION_API mehr, werden seine aktiven Aufgaben pausiert, deren Frequenz nicht MANUAL ist. Ein Workspace-API-Key, den du unter Einstellungen > Workspace > Produkte > API neu anlegst, bekommt einen neuen Service-Account, sieht diese Aufgaben nicht und hält sie nicht am Laufen. Leg sie mit diesem Key neu an. Rotierst du einen Workspace-API-Key, bleibt der Service-Account derselbe, und seine Aufgaben laufen weiter. Widerrufst du einen persönlichen Key, laufen die Aufgaben dieses Mitglieds weiter. MANUAL Aufgaben haben keine Uhrzeit, deshalb ändert diese Pause sie nicht.
Verfügbare Endpoints
Scheduled-Task-Objekt
Auflisten und Abrufen enthaltenrunCount. Erstellen, Aktualisieren, Pausieren und Fortsetzen liefern dasselbe Objekt ohne runCount.
updatedAt gibt es nicht.
Zeitplan
timeOfDay nutzt HH:mm im 24-Stunden-Format. Eine fehlende oder ungültige Uhrzeit bei einer geplanten Frequenz liefert 400.
Kontext an der Aufgabe
assistantId ist der primäre Agent. Er muss für den Key verfügbar sein, sonst liefern Erstellen und Aktualisieren 403 mit AUTOMATION_TAG_ACCESS_DENIED:assistant:{id}.
modelMode EXPLICIT braucht modelId in derselben Anfrage. Das Modell muss für dieses Mitglied oder diesen Service-Account auswählbar sein. Sonst ist die Antwort 403 mit AUTOMATION_TAG_ACCESS_DENIED:model:missing oder AUTOMATION_TAG_ACCESS_DENIED:model:{id}. AUTO und UNSET speichern modelId als null. Lässt du modelMode weg und sendest modelId, wird die Aufgabe als EXPLICIT gespeichert. Lässt du beides weg, wird sie als UNSET gespeichert.
Getaggte Integrationen, Ordner, Workflows, Skills und eine taggedAssistantId, die der Key nicht nutzen kann, werden beim Speichern verworfen. Die Anfrage schlägt dadurch nicht fehl. attachmentIds müssen schon diesem Mitglied oder Service-Account in diesem Workspace gehören. Ein Anhang, den dieser Besitzer nicht hat, liefert 403 mit AUTOMATION_TAG_ACCESS_DENIED:attachment:unknown.
Jedes Tag-Array nimmt höchstens 20 Werte. Jeder Skill-Slug hat höchstens 100 Zeichen. attachmentIds nimmt höchstens 20 IDs.
Rate Limits
Die Scheduled Tasks API folgt den üblichen API Rate Limits. Überschreitest du das Limit, bekommst du429. Warte und versuche es mit exponentiellem Backoff erneut.
Langdock blockiert Anfragen aus Browser-Origins absichtlich, um deinen API-Key zu schützen und deine Anwendungen sicher zu halten. Mehr dazu findest du im Guide zu API Key Best Practices.