--- title: "Changes to Execute Workflow (v2 sync or stream)" method: POST path: "/api/v2/workflows" --- # Changes to Execute Workflow (v2 sync or stream) `POST /api/v2/workflows` > Every recorded change to this operation, newest first. ## Timeline Changed in 9 of 26 revisions. - **2026-10-21** `4349fbe90c64`: 1 breaking, 2 info - **2026-07-21** `22962dc5e81b`: 1 breaking, 12 warning, 17 info - **2026-06-08** `a5c4fa6a88f7`: 3 info - **2026-03-18** `e94ee92b7c9a`: 1 breaking, 6 info - **2026-03-12** `830c31118215`: 1 breaking, 3 info - **2026-03-06** `0be341779529`: 1 info - **2026-02-18** `191b57fc530b`: 1 breaking - **2026-02-10** `0be341779529`: 1 info - **2025-10-16** `9bd3e81318d7`: 1 breaking ## Changes - **2026-10-21** `4349fbe90c64`: 1 breaking, 2 info - added `#/components/schemas/WorkflowExecutionResponse` to the response body `oneOf` list for the response status `200` - added the new optional request property `expose_graph_state` - removed `subschema #1: WorkflowExecutionResponse` from the response body `oneOf` list for the response status `200` - **2026-07-21** `22962dc5e81b`: 1 breaking, 12 warning, 17 info - the `oneOf[subschema #1: WorkflowExecutionResponse]/outputs/additionalProperties/status` response's property type changed from no type to `string` for status `200` - removed the request property `background` - removed the request property `inputs` - removed the request property `stream` - added the new `cancelled` enum value to the `oneOf[subschema #1: WorkflowExecutionResponse]/outputs/additionalProperties/status` response property for the response status `200` - added the new `completed` enum value to the `oneOf[subschema #1: WorkflowExecutionResponse]/outputs/additionalProperties/status` response property for the response status `200` - added the new `failed` enum value to the `oneOf[subschema #1: WorkflowExecutionResponse]/outputs/additionalProperties/status` response property for the response status `200` - added the new `in_progress` enum value to the `oneOf[subschema #1: WorkflowExecutionResponse]/outputs/additionalProperties/status` response property for the response status `200` - added the new `queued` enum value to the `oneOf[subschema #1: WorkflowExecutionResponse]/outputs/additionalProperties/status` response property for the response status `200` - added the new `suspended` enum value to the `oneOf[subschema #1: WorkflowExecutionResponse]/outputs/additionalProperties/status` response property for the response status `200` - added the new `suspended` enum value to the `oneOf[subschema #1: WorkflowExecutionResponse]/status` response property for the response status `200` - added the new `suspended` enum value to the `oneOf[subschema #2: WorkflowJobResponse]/status` response property for the response status `200` - added the new `timed_out` enum value to the `oneOf[subschema #1: WorkflowExecutionResponse]/outputs/additionalProperties/status` response property for the response status `200` - the endpoint scheme security `API key header` was removed from the API - the endpoint scheme security `API key query` was removed from the API - added the new optional request property `data` - added the new optional request property `files` - added the new optional request property `idempotency_key` - added the new optional request property `input_value` - added the new optional request property `mode` - added the new optional request property `output_ids` - added the new optional request property `session_id` - added the new optional request property `start_component_id` - added the new optional request property `stop_component_id` - added the new optional request property `stream_protocol` - added the new optional request property `tweaks` - added the optional property `oneOf[subschema #1: WorkflowExecutionResponse]/human_request` to the response with the `200` status - added the optional property `oneOf[subschema #1: WorkflowExecutionResponse]/output` to the response with the `200` status - added the optional property `oneOf[subschema #1: WorkflowExecutionResponse]/outputs/additionalProperties/display_name` to the response with the `200` status - added the optional property `oneOf[subschema #1: WorkflowExecutionResponse]/session_id` to the response with the `200` status - **2026-06-08** `a5c4fa6a88f7`: 3 info - added the new optional request property `globals` - added the optional property `oneOf[subschema #1: WorkflowExecutionResponse]/globals` to the response with the `200` status - added the optional property `oneOf[subschema #2: WorkflowJobResponse]/globals` to the response with the `200` status - **2026-03-18** `e94ee92b7c9a`: 1 breaking, 6 info - the `oneOf[subschema #1: WorkflowExecutionResponse]/outputs/additionalProperties/status` response's property type changed from `string` to no type for status `200` - removed the `cancelled` enum value from the `oneOf[subschema #1: WorkflowExecutionResponse]/outputs/additionalProperties/status` response property for the response status `200` - removed the `completed` enum value from the `oneOf[subschema #1: WorkflowExecutionResponse]/outputs/additionalProperties/status` response property for the response status `200` - removed the `failed` enum value from the `oneOf[subschema #1: WorkflowExecutionResponse]/outputs/additionalProperties/status` response property for the response status `200` - removed the `in_progress` enum value from the `oneOf[subschema #1: WorkflowExecutionResponse]/outputs/additionalProperties/status` response property for the response status `200` - removed the `queued` enum value from the `oneOf[subschema #1: WorkflowExecutionResponse]/outputs/additionalProperties/status` response property for the response status `200` - removed the `timed_out` enum value from the `oneOf[subschema #1: WorkflowExecutionResponse]/outputs/additionalProperties/status` response property for the response status `200` - **2026-03-12** `830c31118215`: 1 breaking, 3 info - added `subschema #1: WorkflowExecutionResponse, subschema #2: WorkflowJobResponse` to the response body `oneOf` list for the response status `200` - removed `#/components/schemas/WorkflowExecutionResponse, #/components/schemas/WorkflowJobResponse` from the response body `oneOf` list for the response status `200` - added the optional property `detail/items/ctx` to the response with the `422` status - added the optional property `detail/items/input` to the response with the `422` status - **2026-03-06** `0be341779529`: 1 info - endpoint added - **2026-02-18** `191b57fc530b`: 1 breaking - api path removed without deprecation - **2026-02-10** `0be341779529`: 1 info - endpoint added - **2025-10-16** `9bd3e81318d7`: 1 breaking - api path removed without deprecation --- [Operation](https://skmtc.dev/langflow-ai/apis/langflow/docs/api/v2/workflows/post.md) - [API](https://skmtc.dev/langflow-ai/apis/langflow.md) - [Page](https://skmtc.dev/langflow-ai/apis/langflow/changes/api/v2/workflows/post)