Basis-URL
API-Key-Scopes
Jeder Endpoint nutzt denselben Scope.
Lege den Key unter Einstellungen > Workspace > Produkte > API an. Persönliche API-Keys können diese API nicht aufrufen, auch wenn der Scope am Key steht.
Der Key muss zu einem Service-Account gehören. Scheduled Tasks müssen im Workspace aktiv sein, und dieser Service-Account braucht Zugriff. Allgemeiner Zugriff schließt den Account ein. Mitgliederzugriff gilt nur, wenn der Account oder eine seiner Gruppen enthalten ist.
Jede Aufgabe gehört dem Service-Account, der sie erstellt hat. Der Key sieht und ändert nur seine eigenen Aufgaben. Pro Besitzer sind 10 Aufgaben im Workspace möglich. Die elfte Erstellung liefert
400 mit der Message AUTOMATION_LIMIT_REACHED.
Hat dieser Service-Account keinen gültigen Key mit AUTOMATION_API mehr, werden aktive Aufgaben pausiert, deren Frequenz nicht MANUAL ist. Ein verbleibender Key, auch einer aus einer Rotation, lässt diese Aufgaben weiterlaufen. 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 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 dem Service-Account dieses Keys in diesem Workspace gehören. Ein Anhang, der ihm nicht gehört, 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.