---
title: "Changes to Execute Graph Workflow"
method: POST
path: "/v1/graph-workflow/completions"
---

# Changes to Execute Graph Workflow

`POST /v1/graph-workflow/completions`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 8 of 50 revisions.

- **2026-08-31** `2f1c2f286139` — 1 breaking, 1 info
- **2026-08-27** `0882a16375db` — 1 breaking, 4 info
- **2026-08-14** `dd6e1de072c7` — 1 warning, 1 info
- **2026-08-04** `74ed1cde0bfc` — 2 info
- **2026-08-02** `dcbc7787aed7` — 3 info
- **2026-08-01** `90f1182a9c4d` — 26 info
- **2026-07-31** `a4b2639c845e` — 1 breaking, 5 info
- **2026-07-26** `9666c890823b` — 1 breaking, 2 warning, 4 info

## Changes

- **2026-08-31** `2f1c2f286139` — 1 breaking, 1 info
  - removed the required property `usage/token_cost` from the response with the `200` status
  - added the required property `usage/total_cost` to the response with the `200` status
- **2026-08-27** `0882a16375db` — 1 breaking, 4 info
  - removed `#/components/schemas/MultipleMCPConnections` from the `agents/anyOf[subschema #1]/items/mcp_configs` request property `anyOf` list
  - added the new optional request property `agents/anyOf[subschema #1]/items/mcp_urls`
  - added `#/components/schemas/MCPConnection, subschema #3` to the `agents/anyOf[subschema #1]/items/mcp_url` request property `anyOf` list
  - added `subschema #1` to the `agents/anyOf[subschema #1]/items/mcp_configs` request property `anyOf` list
  - added `subschema #2` to the `agents/anyOf[subschema #1]/items/mcp_config` request property `anyOf` list
- **2026-08-14** `dd6e1de072c7` — 1 warning, 1 info
  - the `agents/anyOf[subschema #1]/items/max_tokens/anyOf[subschema #1]/` request property's min was set to `1.00`
  - the `reasoning_effort` request property default value `medium` was removed
- **2026-08-04** `74ed1cde0bfc` — 2 info
  - added the new optional request property `agents/anyOf[subschema #1]/items/fallback_model_name`
  - added the new optional request property `agents/anyOf[subschema #1]/items/fallback_models`
- **2026-08-02** `dcbc7787aed7` — 3 info
  - added the new optional request property `agents/anyOf[subschema #1]/items/top_p`
  - the `dynamic_temperature_enabled` request property default value changed from `true` to `false`
  - the `model_name` request property default value changed from `gpt-4.1` to `claude-sonnet-5`
- **2026-08-01** `90f1182a9c4d` — 26 info
  - added the new optional request property `agents/anyOf[subschema #1]/items/mcp_config/anyOf[subschema #1: MCPConnection]/api_key`
  - added the new optional request property `agents/anyOf[subschema #1]/items/mcp_config/anyOf[subschema #1: MCPConnection]/api_key_header`
  - added the new optional request property `agents/anyOf[subschema #1]/items/mcp_config/anyOf[subschema #1: MCPConnection]/api_key_prefix`
  - added the new optional request property `agents/anyOf[subschema #1]/items/mcp_config/anyOf[subschema #1: MCPConnection]/args`
  - added the new optional request property `agents/anyOf[subschema #1]/items/mcp_config/anyOf[subschema #1: MCPConnection]/auth_type`
  - added the new optional request property `agents/anyOf[subschema #1]/items/mcp_config/anyOf[subschema #1: MCPConnection]/command`
  - added the new optional request property `agents/anyOf[subschema #1]/items/mcp_config/anyOf[subschema #1: MCPConnection]/env`
  - added the new optional request property `agents/anyOf[subschema #1]/items/mcp_config/anyOf[subschema #1: MCPConnection]/name`
  - added the new optional request property `agents/anyOf[subschema #1]/items/mcp_config/anyOf[subschema #1: MCPConnection]/oauth`
  - added the new optional request property `agents/anyOf[subschema #1]/items/mcp_config/anyOf[subschema #1: MCPConnection]/sse_read_timeout`
  - added the new optional request property `agents/anyOf[subschema #1]/items/mcp_config/anyOf[subschema #1: MCPConnection]/tool_timeout`
  - added the new optional request property `agents/anyOf[subschema #1]/items/mcp_configs/anyOf[subschema #1: MultipleMCPConnections]/connections/items/api_key`
  - added the new optional request property `agents/anyOf[subschema #1]/items/mcp_configs/anyOf[subschema #1: MultipleMCPConnections]/connections/items/api_key_header`
  - added the new optional request property `agents/anyOf[subschema #1]/items/mcp_configs/anyOf[subschema #1: MultipleMCPConnections]/connections/items/api_key_prefix`
  - added the new optional request property `agents/anyOf[subschema #1]/items/mcp_configs/anyOf[subschema #1: MultipleMCPConnections]/connections/items/args`
  - added the new optional request property `agents/anyOf[subschema #1]/items/mcp_configs/anyOf[subschema #1: MultipleMCPConnections]/connections/items/auth_type`
  - added the new optional request property `agents/anyOf[subschema #1]/items/mcp_configs/anyOf[subschema #1: MultipleMCPConnections]/connections/items/command`
  - added the new optional request property `agents/anyOf[subschema #1]/items/mcp_configs/anyOf[subschema #1: MultipleMCPConnections]/connections/items/env`
  - added the new optional request property `agents/anyOf[subschema #1]/items/mcp_configs/anyOf[subschema #1: MultipleMCPConnections]/connections/items/name`
  - added the new optional request property `agents/anyOf[subschema #1]/items/mcp_configs/anyOf[subschema #1: MultipleMCPConnections]/connections/items/oauth`
  - added the new optional request property `agents/anyOf[subschema #1]/items/mcp_configs/anyOf[subschema #1: MultipleMCPConnections]/connections/items/sse_read_timeout`
  - added the new optional request property `agents/anyOf[subschema #1]/items/mcp_configs/anyOf[subschema #1: MultipleMCPConnections]/connections/items/tool_timeout`
  - the `timeout` request property default value changed from `10` to `30`
  - the `timeout` request property default value changed from `10` to `30`
  - added the new `minimal` enum value to the request property `agents/anyOf[subschema #1]/items/reasoning_effort/anyOf[subschema #1]/`
  - added the new `none` enum value to the request property `agents/anyOf[subschema #1]/items/reasoning_effort/anyOf[subschema #1]/`
- **2026-07-31** `a4b2639c845e` — 1 breaking, 5 info
  - removed the enum value `minimal` of the request property `agents/anyOf[subschema #1]/items/reasoning_effort/anyOf[subschema #1]/`
  - the `max_tokens` request property default value changed from `8192` to `16000`
  - the `reasoning_effort` request property default value changed from `low` to `medium`
  - added the new `max` enum value to the request property `agents/anyOf[subschema #1]/items/reasoning_effort/anyOf[subschema #1]/`
  - added the new `ultra` enum value to the request property `agents/anyOf[subschema #1]/items/reasoning_effort/anyOf[subschema #1]/`
  - added the new `xhigh` enum value to the request property `agents/anyOf[subschema #1]/items/reasoning_effort/anyOf[subschema #1]/`
- **2026-07-26** `9666c890823b` — 1 breaking, 2 warning, 4 info
  - request property `agents/anyOf[subschema #1]/items/reasoning_effort/anyOf[subschema #1]/` was restricted to a list of enum values
  - the `agents/anyOf[subschema #1]/items/temperature/anyOf[subschema #1]/` request property's max was set to `2.00`
  - the `agents/anyOf[subschema #1]/items/temperature/anyOf[subschema #1]/` request property's min was set to `0.00`
  - added the new `high` enum value to the request property `agents/anyOf[subschema #1]/items/reasoning_effort/anyOf[subschema #1]/`
  - added the new `low` enum value to the request property `agents/anyOf[subschema #1]/items/reasoning_effort/anyOf[subschema #1]/`
  - added the new `medium` enum value to the request property `agents/anyOf[subschema #1]/items/reasoning_effort/anyOf[subschema #1]/`
  - added the new `minimal` enum value to the request property `agents/anyOf[subschema #1]/items/reasoning_effort/anyOf[subschema #1]/`

---

[Operation](https://skmtc.dev/swarms/apis/swarms-api/docs/v1/graph-workflow/completions/post.md) · [API](https://skmtc.dev/swarms/apis/swarms-api.md) · [Page](https://skmtc.dev/swarms/apis/swarms-api/changes/v1/graph-workflow/completions/post)