Skip to main content
PATCH
Update a scheduled task
Aktualisiert eine Scheduled Task, die diesem Workspace-API-Key gehört. Sende mindestens ein Feld. Die Antwort enthält kein runCount. Weggelassene Felder bleiben, wie sie sind. Der Zeitplan wird geprüft, nachdem deine Felder mit der gespeicherten Uhrzeit zusammengeführt wurden. Änderst du nur frequency, kann die gespeicherte timeOfDay weiter gelten. Ein unvollständiger zusammengeführter Zeitplan liefert 400. attachmentIds ersetzen die Anhangliste. Lässt du attachmentIds weg, bleiben die Anhänge. Ein Tag-Array ersetzt dieses Array. Ein leeres Array leert es. Nicht erreichbare getaggte IDs und Slugs werden verworfen.

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.

Parameter

Unbekannte Body-Felder werden abgelehnt. Ein ungültiger Body liefert 400 mit der Message Invalid request und einem errors-Array. Ein leerer Body liefert 400 mit der Message At least one field must be provided. Ein zusammengeführter Zeitplan, der weiter unvollständig ist, liefert 400 mit der Message automation_time_of_day_required, automation_day_of_week_required, automation_day_of_month_required oder automation_days_of_week_required.

Beispiel

Antwortformat

Erfolgreiche Antwort (200 OK)

automation entspricht dem Scheduled-Task-Objekt ohne runCount.

Fehlerbehandlung

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.

Autorisierungen

Authorization
string
header
erforderlich

API key as Bearer token. Format "Bearer YOUR_API_KEY"

Pfadparameter

automationId
string<uuid>
erforderlich

Body

application/json
name
string
Required string length: 1 - 200
prompt
string
Required string length: 1 - 120000
frequency
enum<string>
Verfügbare Optionen:
MANUAL,
DAILY,
WEEKDAYS,
WEEKLY,
MONTHLY,
SELECTED_WEEKDAYS
timeOfDay
string | null

24 hour HH:mm. Omitted keeps the stored value.

dayOfWeek
integer | null

0 is Sunday and 6 is Saturday. Omitted keeps the stored value.

Erforderlicher Bereich: 0 <= x <= 6
dayOfMonth
integer | null

Omitted keeps the stored value.

Erforderlicher Bereich: 1 <= x <= 31
daysOfWeek
integer[]

Omitted keeps the stored value.

Maximum array length: 7
Erforderlicher Bereich: 0 <= x <= 6
timezone
string | null

IANA timezone. Omitted keeps the stored value. Empty is stored as UTC on a scheduled frequency.

Maximum string length: 64
modelMode
enum<string>
Verfügbare Optionen:
UNSET,
EXPLICIT,
AUTO
modelId
string<uuid> | null

Required in this request when modelMode is EXPLICIT.

assistantId
string<uuid> | null
taggedAssistantId
string<uuid> | null
taggedIntegrationIds
string<uuid>[]
Maximum array length: 20
taggedKnowledgeFolderIds
string<uuid>[]
Maximum array length: 20
taggedWorkflowIds
string<uuid>[]
Maximum array length: 20
taggedSkillSlugs
string[]
Maximum array length: 20
Maximum string length: 100
attachmentIds
string<uuid>[]
Maximum array length: 20

Antwort

Scheduled task updated. The automation object does not include runCount.