Publish Workflow

Publishes the current draft as a new production version. This is the same action as Publish in the builder. The new version becomes active, scheduled and webhook triggers start, and the workflow is marked ACTIVE.

Base URL

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

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) and editor access.

Parameters

Parameter	Type	Required	Description
`workflowId`	string	Yes	UUID of the workflow.
`bumpType`	string	Yes	Version bump: `major`, `minor`, or `patch`.
`description`	string	No	Version description. Maximum: 255 characters.
`timezone`	string	No	Valid IANA timezone. Stored only when a valid name is sent.

Publish is rejected when the draft has a disconnected trigger, when a webhook is unauthenticated and the workspace requires webhook auth, or when the workflow is a template. Pause a live workflow with update and status: "INACTIVE".

Example

const axios = require("axios");

async function publishWorkflow(workflowId) {
  const response = await axios.post(
    "https://api.langdock.com/workflows/v1/publish",
    {
      workflowId,
      bumpType: "patch",
      description: "Initial production version"
    },
    {
      headers: {
        Authorization: "Bearer YOUR_API_KEY",
        "Content-Type": "application/json"
      }
    }
  );

  console.log("Published version:", response.data.workflow.activeVersion?.version);
}

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

Response format

Success response (200 OK)

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

workflow matches the object on Workflow API Overview.

Error handling

Status code	Description
400	Invalid body, disconnected trigger, webhook auth required, template workflow, or missing draft
401	Invalid or missing API key
403	Missing `WORKFLOW_WRITE_API` scope or editor access. A missing workflow, a template, or a workflow in another workspace also returns this status.
429	Rate limit exceeded
500	Internal server error
503	Publishing timed out (`WORKFLOW_PUBLISH_TIMEOUT`). No version was created. Retry the same request.

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

Publish 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