Workflow aktualisieren

Aktualisiert Metadaten oder den Entwurfsgraphen für einen Workflow, den der API-Key-User bearbeiten kann. Ein Update am Entwurf veröffentlicht keine neue Version. Sende in einer Anfrage entweder Metadaten (inklusive limits) oder ein Graph-Update. Mische sie nicht.

Basis-URL

https://api.langdock.com/workflows/v1/update

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

Erforderliche Scopes

Dieser Endpoint erfordert den WORKFLOW_WRITE_API Scope (Workflow-Schreib-API) und Bearbeiterzugriff.

Parameter

Parameter	Typ	Erforderlich	Beschreibung
`workflowId`	string	Ja	UUID des Workflows.
`name`	string	Nein	Workflow-Name. Maximum: 60 Zeichen.
`description`	string	Nein	Workflow-Beschreibung. Maximum: 500 Zeichen.
`status`	string	Nein	`ACTIVE` oder `INACTIVE`. `ACTIVE` braucht eine veröffentlichte Version. Nutze `INACTIVE`, um einen laufenden Workflow zu pausieren.
`timezone`	string	Nein	Gültige IANA-Zeitzone. Wird gespeichert, wenn `status` fehlt oder `ACTIVE` ist. Wird ignoriert, wenn `status` `INACTIVE` ist, damit eine Pause die Cron-Zeitzone nicht überschreibt.
`nodes`	array	Nein	Vollständiger Ersatz der Entwurf-Nodes. Muss zusammen mit `edges` gesendet werden, nicht mit `patch` oder Metadaten.
`edges`	array	Nein	Vollständiger Ersatz der Entwurf-Kanten. Muss zusammen mit `nodes` gesendet werden.
`patch`	object	Nein	Inkrementelle Graph-Operationen statt eines vollständigen `nodes`- und `edges`-Ersatzes. Nicht zusammen mit `nodes` und `edges` oder mit Metadaten senden.
`limits`	object	Nein	Ausführungslimits mit denselben Feldern und Bereichen wie bei Workflow erstellen. Weggelassene Felder bleiben unverändert. Sende `null` auf einem Feld, um es zu leeren. Darf mit anderen Metadaten gesendet werden, nicht mit einem Graph-Update. `monthlyCostUsd` darf das Maximale monatliche Limit (USD) des Workspaces nicht überschreiten und lässt sich nicht ändern, wenn in den Einstellungen Limit vom Workspace-Admin festgelegt steht.

Um den Entwurfsgraphen zu ersetzen, sende nodes und edges. Für eine inkrementelle Graph-Änderung sende patch. Ein redigierter Secret-Wert aus Abrufen behält das gespeicherte Secret. Sende einen neuen, nicht leeren Wert, um ein Secret zu rotieren, oder null, um ein Secret-Feld zu leeren.

Beispiel

const axios = require("axios");

async function pauseWorkflow(workflowId) {
  const response = await axios.patch(
    "https://api.langdock.com/workflows/v1/update",
    {
      workflowId,
      status: "INACTIVE"
    },
    {
      headers: {
        Authorization: "Bearer YOUR_API_KEY",
        "Content-Type": "application/json"
      }
    }
  );

  console.log("Status:", response.data.workflow.status);
}

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

Antwortformat

Erfolgreiche Antwort (200 OK)

{
  status: "success";
  message: "Workflow updated successfully";
  workflow: object;
}

workflow entspricht dem Objekt in der Workflow API Übersicht.

Fehlerbehandlung

Statuscode	Beschreibung
400	Ungültiger Body, gemischter Graph und Metadaten, `nodes` ohne `edges`, keine Felder, oder Aktivierung ohne veröffentlichte Version
401	Ungültiger oder fehlender API-Key
403	Fehlender `WORKFLOW_WRITE_API` Scope oder Bearbeiterzugriff. Ein fehlender Workflow, eine Vorlage oder ein Workflow in einem anderen Workspace gibt denselben Status zurück. Ein Graph-Update mit Meeting End ohne Meetings gibt `MEETINGS_FEATURE_FLAG_DISABLED` zurück.
429	Rate Limit überschritten
500	Interner Serverfehler

Langdock blockiert bewusst Browser-basierte Anfragen, um deinen API-Schlüssel zu schützen und die Sicherheit deiner Anwendungen zu gewährleisten. Weitere Informationen findest du in unserem Guide zu Best Practices für API-Schlüssel.

Ü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

Workflow aktualisieren

Basis-URL

Erforderliche Scopes

Parameter

Beispiel

Antwortformat

Erfolgreiche Antwort (200 OK)

Fehlerbehandlung

​Basis-URL

​Erforderliche Scopes

​Parameter

​Beispiel

​Antwortformat

​Erfolgreiche Antwort (200 OK)

​Fehlerbehandlung

Basis-URL

Erforderliche Scopes

Parameter

Beispiel

Antwortformat

Erfolgreiche Antwort (200 OK)

Fehlerbehandlung