---
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 operation, newest first.

## Timeline

Changed in 2 of 54 revisions.

- **2026-10-31** `3e13975ede3d`: 1 info
- **2026-10-16** `500c79520e41`: 4 breaking, 3 warning, 49 info

## Changes

- **2026-10-31** `3e13975ede3d`: 1 info
  - added the optional property `usage/flash_sale_applied` to the response with the `200` status
- **2026-10-16** `500c79520e41`: 4 breaking, 3 warning, 49 info
  - removed `#/components/schemas/MultipleMCPConnections` from the `agents/anyOf[subschema #1]/items/mcp_configs` request property `anyOf` list
  - request property `agents/anyOf[subschema #1]/items/reasoning_effort/anyOf[subschema #1]/` was restricted to a list of enum values
  - the response property `usage/cost_per_agent` became optional for the status `200`
  - removed the required property `usage/token_cost` from the response with the `200` status
  - 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/max_tokens/anyOf[subschema #1]/` request property's min was set to `1.00`
  - the `agents/anyOf[subschema #1]/items/temperature/anyOf[subschema #1]/` request property's min was set to `0.00`
  - added the new optional request property `agents/anyOf[subschema #1]/items/capabilities`
  - added the new optional request property `agents/anyOf[subschema #1]/items/category`
  - 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`
  - added the new optional request property `agents/anyOf[subschema #1]/items/handoffs`
  - added the new optional request property `agents/anyOf[subschema #1]/items/is_free`
  - added the new optional request property `agents/anyOf[subschema #1]/items/marketplace_prompt_id`
  - 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_urls`
  - added the new optional request property `agents/anyOf[subschema #1]/items/price_usd`
  - added the new optional request property `agents/anyOf[subschema #1]/items/publish_to_marketplace`
  - added the new optional request property `agents/anyOf[subschema #1]/items/selected_tools`
  - added the new optional request property `agents/anyOf[subschema #1]/items/tags`
  - added the new optional request property `agents/anyOf[subschema #1]/items/top_p`
  - added the new optional request property `agents/anyOf[subschema #1]/items/use_cases`
  - 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
  - the request property `agents/anyOf[subschema #1]/items/agent_name` became optional
  - the `dynamic_temperature_enabled` request property default value changed from `true` to `false`
  - the `max_tokens` request property default value changed from `8192` to `16000`
  - the `model_name` request property default value changed from `gpt-4.1` to `claude-sonnet-5`
  - the `timeout` request property default value changed from `10` to `30`
  - …16 more

---

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