Zum Hauptinhalt springen
Erstellt eine Scheduled Task, die dem Mitglied oder dem Service-Account dieses Keys gehört. Neue Aufgaben starten mit active auf true. Der Status der Antwort ist 201. Der Body enthält kein runCount.

Basis-URL

Dedicated DeploymentsErsetze api.langdock.com durch <your-deployment-url>/api/public in allen Anfragen.

Benötigte Scopes

Dieser Endpoint braucht den Scope AUTOMATION_API (Scheduled Tasks API) auf einem Workspace-API-Key oder auf einem persönlichen API-Key, nachdem dein Admin den Scope erlaubt hat. Ein Workspace kann 10 Aufgaben für diesen Besitzer halten. Die nächste Erstellung liefert 400 mit der Message AUTOMATION_LIMIT_REACHED. Eine abgelaufene Trial liefert 403 mit dem Code TRIAL_EXPIRED.

Parameter

Sende einen JSON-Body. Unbekannte Felder werden abgelehnt. Die Zeitplanregeln stehen in der Scheduled Tasks API Übersicht.

Beispiel

Antwortformat

Erfolgreiche Antwort (201 Created)

automation entspricht dem Scheduled-Task-Objekt ohne runCount.

Fehlerbehandlung

Ein ungültiger Body liefert 400 mit der Message Invalid request und einem errors-Array. Fehlende Uhrzeitfelder nutzen timeOfDay is required for scheduled automations, dayOfWeek is required for weekly automations, dayOfMonth is required for monthly automations oder daysOfWeek is required for selected weekday automations. Eine ungültige Zeitzone nutzt timezone must be a valid IANA identifier. modelMode EXPLICIT ohne modelId nutzt modelId is required for explicit model selection. Eine abgelaufene Trial liefert 403 mit dem Code TRIAL_EXPIRED und der Message Your trial has expired. Upgrade to continue.
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.