---
title: "Changes to Create a workflow"
method: POST
path: "/v1/workflows"
---

# Changes to Create a workflow

`POST /v1/workflows`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 3 revisions.

- **2026-08-12** `5a5597ebb2d6`: 2 breaking, 6 warning, 11 info

## Changes

- **2026-08-12** `5a5597ebb2d6`: 2 breaking, 6 warning, 11 info
  - the response property `active_revision/anyOf[subschema #1: WorkflowRevisionResponse]/tools/items/tool/active_revision/anyOf[subschema #1: ToolRevisionResponse]/transfer_target/anyOf[subschema #1: TransferTargetView]/destination` became optional for the status `201`
  - response property `active_revision/anyOf[subschema #1: WorkflowRevisionResponse]/tools/items/tool/active_revision/anyOf[subschema #1: ToolRevisionResponse]/transfer_target/anyOf[subschema #1: TransferTargetView]/destination` list-of-types was widened by adding types `null` to media type `application/json` of response `201`
  - removed the optional property `active_revision/anyOf[subschema #1: WorkflowRevisionResponse]/system_prompt` from the response with the `201` status
  - removed the optional property `active_revision/anyOf[subschema #1: WorkflowRevisionResponse]/tools/items/tool_revision_id` from the response with the `201` status
  - added the new `max` enum value to the `active_revision/anyOf[subschema #1: WorkflowRevisionResponse]/analyzer_model_settings/anyOf[subschema #1: ModelChainEntry]/config/reasoning_effort/anyOf[subschema #1]/` response property for the response status `201`
  - added the new `max` enum value to the `active_revision/anyOf[subschema #1: WorkflowRevisionResponse]/router_model_settings/anyOf[subschema #1: ModelChainEntry]/config/reasoning_effort/anyOf[subschema #1]/` response property for the response status `201`
  - added the new `minimal` enum value to the `active_revision/anyOf[subschema #1: WorkflowRevisionResponse]/analyzer_model_settings/anyOf[subschema #1: ModelChainEntry]/config/reasoning_effort/anyOf[subschema #1]/` response property for the response status `201`
  - added the new `minimal` enum value to the `active_revision/anyOf[subschema #1: WorkflowRevisionResponse]/router_model_settings/anyOf[subschema #1: ModelChainEntry]/config/reasoning_effort/anyOf[subschema #1]/` response property for the response status `201`
  - added the new optional request property `kind`
  - added the optional property `active_revision/anyOf[subschema #1: WorkflowRevisionResponse]/executable_graph` to the response with the `201` status
  - added the optional property `active_revision/anyOf[subschema #1: WorkflowRevisionResponse]/graph_version` to the response with the `201` status
  - added the optional property `active_revision/anyOf[subschema #1: WorkflowRevisionResponse]/tools/items/tool/active_revision/anyOf[subschema #1: ToolRevisionResponse]/compatibility` to the response with the `201` status
  - added the optional property `active_revision/anyOf[subschema #1: WorkflowRevisionResponse]/tools/items/tool/active_revision/anyOf[subschema #1: ToolRevisionResponse]/transfer_target/anyOf[subschema #1: TransferTargetView]/destination_source` to the response with the `201` status
  - added the optional property `active_revision/anyOf[subschema #1: WorkflowRevisionResponse]/warnings` to the response with the `201` status
  - added the optional property `kind` to the response with the `201` status
  - added the optional property `retry_after` to the response with the `400` status
  - added the optional property `retry_after` to the response with the `401` status
  - added the optional property `retryable` to the response with the `400` status
  - added the optional property `retryable` to the response with the `401` status

---

[Operation](https://skmtc.dev/oneloop-hq/apis/feather-api/docs/v1/workflows/post.md) - [API](https://skmtc.dev/oneloop-hq/apis/feather-api.md) - [Page](https://skmtc.dev/oneloop-hq/apis/feather-api/changes/v1/workflows/post)