Scheduled Task aktualisieren

Aktualisiert eine Scheduled Task, die dem Mitglied oder dem Service-Account dieses Keys 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

https://api.langdock.com/automations/v1/{automationId}

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.

Parameter

Parameter	In	Typ	Pflicht	Beschreibung
`automationId`	Pfad	string	Ja	UUID der Scheduled Task.
`name`	Body	string	Nein	1 bis 200 Zeichen.
`prompt`	Body	string	Nein	1 bis 120000 Zeichen.
`frequency`	Body	string	Nein	`MANUAL`, `DAILY`, `WEEKDAYS`, `WEEKLY`, `MONTHLY` oder `SELECTED_WEEKDAYS`.
`timeOfDay`	Body	string \| null	Nein	`HH:mm` im 24-Stunden-Format.
`dayOfWeek`	Body	integer \| null	Nein	0 (Sonntag) bis 6 (Samstag).
`dayOfMonth`	Body	integer \| null	Nein	1 bis 31.
`daysOfWeek`	Body	integer[]	Nein	Tage von 0 bis 6. Höchstens 7 Werte.
`timezone`	Body	string \| null	Nein	IANA-Name, höchstens 64 Zeichen.
`modelMode`	Body	string	Nein	`UNSET`, `EXPLICIT` oder `AUTO`.
`modelId`	Body	string \| null	Nein	Pflicht in dieser Anfrage, wenn `modelMode` `EXPLICIT` ist.
`assistantId`	Body	string \| null	Nein	Primärer Agent. `null` entfernt ihn.
`taggedAssistantId`	Body	string \| null	Nein	Zusätzliche Agentenerwähnung. `null` entfernt sie.
`taggedIntegrationIds`	Body	string[]	Nein	Ersetzt die Liste. Höchstens 20.
`taggedKnowledgeFolderIds`	Body	string[]	Nein	Ersetzt die Liste. Höchstens 20.
`taggedWorkflowIds`	Body	string[]	Nein	Ersetzt die Liste. Höchstens 20.
`taggedSkillSlugs`	Body	string[]	Nein	Ersetzt die Liste. Höchstens 20.
`attachmentIds`	Body	string[]	Nein	Ersetzt die Anhänge. Höchstens 20. Jede ID muss diesem Key gehören.

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

const axios = require("axios");

async function updateScheduledTask(automationId) {
  const response = await axios.patch(
    `https://api.langdock.com/automations/v1/${automationId}`,
    {
      prompt: "Summarize overnight pipeline changes and flag deals that slipped."
    },
    {
      headers: {
        Authorization: "Bearer YOUR_API_KEY",
        "Content-Type": "application/json"
      }
    }
  );

  console.log(response.data.automation.name);
}

updateScheduledTask("550e8400-e29b-41d4-a716-446655440000");

Antwortformat

Erfolgreiche Antwort (200 OK)

automation entspricht dem Scheduled-Task-Objekt ohne runCount.

{
  automation: {
    id: string;
    createdAt: string;
    name: string;
    prompt: string;
    frequency:
      | "MANUAL"
      | "DAILY"
      | "WEEKDAYS"
      | "WEEKLY"
      | "MONTHLY"
      | "SELECTED_WEEKDAYS";
    timeOfDay: string | null;
    dayOfWeek: number | null;
    dayOfMonth: number | null;
    daysOfWeek: number[];
    timezone: string | null;
    active: boolean;
    modelId: string | null;
    modelMode: "UNSET" | "EXPLICIT" | "AUTO";
    assistantId: string | null;
    taggedAssistantId: string | null;
    lastRunAt: string | null;
    attachments: Array<{
      id: string;
      name: string;
      mimeType: string | null;
      type: string | null;
    }>;
    taggedIntegrationIds: string[];
    taggedKnowledgeFolderIds: string[];
    taggedWorkflowIds: string[];
    taggedSkillSlugs: string[];
  };
}

Fehlerbehandlung

Statuscode	Beschreibung
400	Ungültiger Body, Message `At least one field must be provided.` oder ein unvollständiger zusammengeführter Zeitplan
401	Ungültiger oder fehlender API-Key, oder der Key-User wurde nicht gefunden
403	`AUTOMATION_API` fehlt, Scheduled Tasks deaktiviert, kein Produktzugriff oder `AUTOMATION_TAG_ACCESS_DENIED`
404	Message `AUTOMATION_NOT_FOUND`
405	Methode nicht erlaubt
429	Rate Limit überschritten
500	Interner Serverfehler

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.

Überblick

Completion API

Embedding API

Agents API

Integrations API

Skills API

Knowledge Folder API

Prompt Library API

Usage Export API

Workflow API

Scheduled Tasks API

User Management API

Billing API

Audit Logs API

Governance API

Compliance API

Scheduled Task aktualisieren

Basis-URL

Benötigte Scopes

Parameter

Beispiel

Antwortformat

Erfolgreiche Antwort (200 OK)

Fehlerbehandlung

​Basis-URL

​Benötigte Scopes

​Parameter

​Beispiel

​Antwortformat

​Erfolgreiche Antwort (200 OK)

​Fehlerbehandlung

Basis-URL

Benötigte Scopes

Parameter

Beispiel

Antwortformat

Erfolgreiche Antwort (200 OK)

Fehlerbehandlung