---
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.

---

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