---
title: "Changes to Create a workflow"
method: POST
path: "/v1/workspaces/{workspaceId}/workflows"
---

# Changes to Create a workflow

`POST /v1/workspaces/{workspaceId}/workflows`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 6 of 70 revisions.

- **2026-05-14** `8881c619a52a`: 1 info
- **2026-05-14** `14f652e12089`: 2 info
- **2026-03-31** `f260e98102ab`: 1 breaking, 1 info
- **2026-03-30** `9c961c6052c4`: 2 breaking, 1 warning, 1 info
- **2026-03-12** `95ad4756775e`: 3 breaking, 1 info
- **2026-02-11** `e92f886ec95b`: 1 info

## Changes

- **2026-05-14** `8881c619a52a`: 1 info
  - added the non-success response with the status `409`
- **2026-05-14** `14f652e12089`: 2 info
  - added the new optional request property `slug`
  - added the required property `slug` to the response with the `201` status
- **2026-03-31** `f260e98102ab`: 1 breaking, 1 info
  - removed the success response with the status `202`
  - added the success response with the status `201`
- **2026-03-30** `9c961c6052c4`: 2 breaking, 1 warning, 1 info
  - added the new required request property `jobAgents`
  - removed the required property `jobs` from the response with the `202` status
  - removed the request property `jobs`
  - added the required property `jobAgents` to the response with the `202` status
- **2026-03-12** `95ad4756775e`: 3 breaking, 1 info
  - removed `#/components/schemas/JsonSelector, #/components/schemas/CelSelector` from the `inputs/items/oneOf[#/components/schemas/WorkflowArrayInput]/oneOf[#/components/schemas/WorkflowSelectorArrayInput]/selector/default` request property `oneOf` list
  - the `inputs/items/oneOf[#/components/schemas/WorkflowArrayInput]/oneOf[#/components/schemas/WorkflowSelectorArrayInput]/selector/default` request property type changed from no type to `string`
  - the `inputs/items/oneOf[#/components/schemas/WorkflowArrayInput]/oneOf[#/components/schemas/WorkflowSelectorArrayInput]/selector/default` response's property type changed from no type to `string` for status `202`
  - removed `#/components/schemas/JsonSelector, #/components/schemas/CelSelector` from the `inputs/items/oneOf[#/components/schemas/WorkflowArrayInput]/oneOf[#/components/schemas/WorkflowSelectorArrayInput]/selector/default` response property `oneOf` list for the response status `202`
- **2026-02-11** `e92f886ec95b`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/ctrlplanedev/apis/ctrlplane-api/docs/v1/workspaces/:workspaceId/workflows/post.md) - [API](https://skmtc.dev/ctrlplanedev/apis/ctrlplane-api.md) - [Page](https://skmtc.dev/ctrlplanedev/apis/ctrlplane-api/changes/v1/workspaces/:workspaceId/workflows/post)