Workflow erstellen

Erstellt einen inaktiven, unveröffentlichten Entwurf, der dem API-Key-User gehört. Das Erstellen veröffentlicht den Workflow nicht und startet keine Zeitpläne oder Webhooks.

Basis-URL

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

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). Der Key-User braucht außerdem die Berechtigung createWorkflows.

shareWith erfordert die Berechtigung shareWorkflows. Ein unbekanntes oder nicht teilbares Ziel bricht die Anfrage mit 404 ab, und der Workflow wird nicht erstellt.

Parameter

Parameter	Typ	Erforderlich	Beschreibung
`name`	string	Ja	Workflow-Name. Maximum: 60 Zeichen.
`description`	string	Nein	Workflow-Beschreibung. Maximum: 500 Zeichen.
`timezone`	string	Nein	Gültige IANA-Zeitzone, zum Beispiel `Europe/Berlin`.
`initialTriggerKind`	string	Nein	Starter-Trigger: `manual`, `webhook`, `scheduled`, `form`, `integration` oder `meeting_end` (Meeting End). Nicht zusammen mit `nodes` und `edges` senden. `meeting_end` braucht Meetings für den Key-User. Sonst kommt `403` mit `MEETINGS_FEATURE_FLAG_DISABLED`.
`nodes`	array	Nein	Entwurf-Nodes. Muss zusammen mit `edges` gesendet werden.
`edges`	array	Nein	Entwurf-Kanten. Muss zusammen mit `nodes` gesendet werden.
`shareWith`	object	Nein	User und Gruppen zum Teilen. `userIds` und `groupIds` sind UUID-Arrays (jeweils maximal 100). `role` ist `user` (Betrachter) oder `editor` (Standard `editor`).
`limits`	object	Nein	Ausführungslimits. `monthlyCostUsd` ist 1 bis 10000. `perRunCostUsd` ist 1 bis 100. `maxExecutionsPerHour` ist 1 bis 5000. Sende `null` auf einem Feld, um es zu leeren. Weggelassene Felder nutzen die Builder-Standards: 25 USD monatlich (oder den Workspace-Standard), 2 USD pro Ausführung und 100 Ausführungen pro Stunde. `monthlyCostUsd` darf das Maximale monatliche Limit (USD) des Workspaces nicht überschreiten.

Der Graph nutzt dasselbe Node- und Kanten-Schema wie der Workflow-Builder. Vorlagen kannst du über diese API nicht erstellen.

Beispiel

const axios = require("axios");

async function createWorkflow() {
  const response = await axios.post(
    "https://api.langdock.com/workflows/v1/create",
    {
      name: "Sync content",
      description: "Synchronizes content",
      timezone: "Europe/Berlin",
      initialTriggerKind: "manual",
      shareWith: {
        userIds: ["7c9e6679-7425-40de-944b-e07fc1f90ae7"],
        groupIds: [],
        role: "editor"
      }
    },
    {
      headers: {
        Authorization: "Bearer YOUR_API_KEY",
        "Content-Type": "application/json"
      }
    }
  );

  console.log("Created workflow:", response.data.workflow.id);
}

createWorkflow();

Antwortformat

Erfolgreiche Antwort (200 OK)

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

workflow entspricht dem Objekt in der Workflow API Übersicht. Ohne shareWith sieht nur der Key (und Workspace-Admins in der Governance) den Entwurf, bis er geteilt wird.

Fehlerbehandlung

Statuscode	Beschreibung
400	Ungültiger Body, `initialTriggerKind` zusammen mit einem Graphen, oder `nodes` ohne `edges`
401	Ungültiger oder fehlender API-Key
403	Fehlender `WORKFLOW_WRITE_API` Scope, `createWorkflows` oder `shareWorkflows`. `meeting_end` ohne Meetings gibt `MEETINGS_FEATURE_FLAG_DISABLED` zurück.
404	Ein `shareWith`-Ziel ist unbekannt oder nicht teilbar
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 erstellen

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