---
title: "Deploy a workflow version"
method: POST
path: "/api/workflows/{workflow_id}/deployments/"
tags: ["workflows"]
---

# Deploy a workflow version

`POST /api/workflows/{workflow_id}/deployments/`

Deploy one committed workflow version and disable any previously deployed version in the family. Omitting `version` deploys the latest committed version.

## Path parameters

- `workflow_id` string, required

## Headers

- `Authorization` string, required

## Request body

- object
  - `version` integer

## Response `200`

Workflow version deployed.

- WorkflowsDeployWorkflowResponse200
  - `id` string, required
  - `workflow_id` string, required
  - `version` integer, required
  - `is_enabled` boolean, required
  - `is_read_only` boolean, required

## Other responses

- `400` — Invalid request.
- `401` — Authentication failed.
- `404` — Workflow family or committed version not found.

## Changes

> 6 revisions in range; 3 could not be searched.

- **2026-07-31** `c26d550029f8` — 7 info
  - removed the non-success response with the status `401`
  - removed the non-success response with the status `404`
  - the response property `id` became required for the status `200`
  - the response property `is_enabled` became required for the status `200`
  - …3 more

[Change history](https://skmtc.dev/keywordsai/apis/api-reference/changes/api/workflows/:workflow_id/deployments/post.md)

---

[API](https://skmtc.dev/keywordsai/apis/api-reference.md) · [All operations](https://skmtc.dev/keywordsai/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/keywordsai/api-reference/revisions/c61efaf24756/schema)