Create Workflow

Creates an inactive unpublished draft owned by the API key user. Creating a workflow does not publish it or start schedules and webhooks.

Base URL

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

Dedicated deploymentsReplace api.langdock.com with <your-deployment-url>/api/public in all requests.

Required scopes

This endpoint requires the WORKFLOW_WRITE_API scope (Workflow Write API). The key user also needs the createWorkflows permission.

shareWith requires the shareWorkflows permission. An unknown or unshareable target fails the request with 404 and the workflow is not created.

Parameters

Parameter	Type	Required	Description
`name`	string	Yes	Workflow name. Maximum: 60 characters.
`description`	string	No	Workflow description. Maximum: 500 characters.
`timezone`	string	No	Valid IANA timezone, for example `Europe/Berlin`.
`initialTriggerKind`	string	No	Starter trigger: `manual`, `webhook`, `scheduled`, `form`, `integration`, or `meeting_end` (Meeting End). Do not send this together with `nodes` and `edges`. `meeting_end` requires Meetings for the key user. Otherwise the request returns `403` with `MEETINGS_FEATURE_FLAG_DISABLED`.
`nodes`	array	No	Draft nodes. Must be sent together with `edges`.
`edges`	array	No	Draft edges. Must be sent together with `nodes`.
`shareWith`	object	No	Users and groups to share with. `userIds` and `groupIds` are UUID arrays (maximum 100 each). `role` is `user` (viewer) or `editor` (default `editor`).
`limits`	object	No	Execution caps. `monthlyCostUsd` is 1 to 10000. `perRunCostUsd` is 1 to 100. `maxExecutionsPerHour` is 1 to 5000. Send `null` on a field to clear it. Omitted fields use builder defaults: $25 monthly (or the workspace default), $2 per run, and 100 executions per hour. `monthlyCostUsd` cannot exceed the workspace Maximum monthly limit (USD).

The graph uses the same node and edge schema as the workflow builder. Templates cannot be created through this API.

Example

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();

Response format

Success response (200 OK)

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

workflow matches the object on Workflow API Overview. Without shareWith, only the key (and workspace admins in governance) can see the draft until it is shared.

Error handling

Status code	Description
400	Invalid body, mixed `initialTriggerKind` with a graph, `nodes` without `edges`, or a limit out of range or above the workspace monthly maximum
401	Invalid or missing API key
403	Missing `WORKFLOW_WRITE_API` scope, `createWorkflows`, or `shareWorkflows`. `meeting_end` without Meetings returns `MEETINGS_FEATURE_FLAG_DISABLED`.
404	A `shareWith` target is unknown or cannot be shared
429	Rate limit exceeded
500	Internal server error

Langdock intentionally blocks browser-origin requests to protect your API key and ensure your applications remain secure. For more information, please see our guide on API Key Best Practices.

Overview

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

Create Workflow

Base URL

Required scopes

Parameters

Example

Response format

Success response (200 OK)

Error handling

​Base URL

​Required scopes

​Parameters

​Example

​Response format

​Success response (200 OK)

​Error handling

Base URL

Required scopes

Parameters

Example

Response format

Success response (200 OK)

Error handling