---
title: "Publish a workflow"
method: POST
path: "/workflows/v1/publish"
tags: ["Workflows"]
---

# Publish a workflow

`POST /workflows/v1/publish`

## Request

- Base URL: `https://api.langdock.com`
- URL: `https://api.langdock.com/workflows/v1/publish`
- Auth: HTTP bearer

Publishes the current draft as a new production version.

## Request body

- object
  - `workflowId` string, uuid, required
  - `bumpType` 'major' | 'minor' | 'patch', required
  - `description` string
  - `timezone` string: Valid IANA timezone. Stored only when a valid name is sent.

## Response `200`

Workflow published successfully

## Other responses

- `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. No version was created, so the request can be retried.

## Changes

- **2026-11-03** `c62bf90b4013`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/langdock/apis/langdock-api/changes/workflows/v1/publish/post.md)

---

[API](https://skmtc.dev/langdock/apis/langdock-api.md) - [All operations](https://skmtc.dev/langdock/apis/langdock-api/llms.txt) - [OpenAPI document](https://skmtc.dev/langdock/apis/langdock-api/revisions/c62bf90b4013?raw)