Skip to main content
POST
Publish a 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

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

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

Response format

Success response (200 OK)

workflow matches the object on Workflow API Overview.

Error handling

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.

Authorizations

Authorization
string
header
required

API key as Bearer token. Format "Bearer YOUR_API_KEY"

Body

application/json
workflowId
string<uuid>
required
bumpType
enum<string>
required
Available options:
major,
minor,
patch
description
string
Maximum string length: 255
timezone
string

Valid IANA timezone. Stored only when a valid name is sent.

Response

Workflow published successfully