---
title: "Changes to Execute Batched Grid Workflow"
method: POST
path: "/v1/batched-grid-workflow/completions"
---

# Changes to Execute Batched Grid Workflow

`POST /v1/batched-grid-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`: 8 breaking, 5 warning, 50 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`: 8 breaking, 5 warning, 50 info
  - removed `#/components/schemas/MultipleMCPConnections` from the `agent_completions/anyOf[subschema #1]/items/mcp_configs` request property `anyOf` list
  - request property `agent_completions/anyOf[subschema #1]/items/reasoning_effort/anyOf[subschema #1]/` was restricted to a list of enum values
  - the response property `description` became optional for the status `200`
  - the response property `name` became optional for the status `200`
  - the response property `usage/cost_per_agent` became optional for the status `200`
  - response property `description` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `name` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - removed the required property `usage/token_cost` from the response with the `200` status
  - the `agent_completions/anyOf[subschema #1]/items/temperature/anyOf[subschema #1]/` request property's max was set to `2.00`
  - the `max_loops/anyOf[subschema #1]/` request property's max was set to `50.00`
  - the `agent_completions/anyOf[subschema #1]/items/max_tokens/anyOf[subschema #1]/` request property's min was set to `1.00`
  - the `agent_completions/anyOf[subschema #1]/items/temperature/anyOf[subschema #1]/` request property's min was set to `0.00`
  - the `max_loops/anyOf[subschema #1]/` request property's min was set to `1.00`
  - added the new optional request property `agent_completions/anyOf[subschema #1]/items/capabilities`
  - added the new optional request property `agent_completions/anyOf[subschema #1]/items/category`
  - added the new optional request property `agent_completions/anyOf[subschema #1]/items/fallback_model_name`
  - added the new optional request property `agent_completions/anyOf[subschema #1]/items/fallback_models`
  - added the new optional request property `agent_completions/anyOf[subschema #1]/items/handoffs`
  - added the new optional request property `agent_completions/anyOf[subschema #1]/items/is_free`
  - added the new optional request property `agent_completions/anyOf[subschema #1]/items/marketplace_prompt_id`
  - added the new optional request property `agent_completions/anyOf[subschema #1]/items/mcp_config/anyOf[subschema #1: MCPConnection]/api_key`
  - added the new optional request property `agent_completions/anyOf[subschema #1]/items/mcp_config/anyOf[subschema #1: MCPConnection]/api_key_header`
  - added the new optional request property `agent_completions/anyOf[subschema #1]/items/mcp_config/anyOf[subschema #1: MCPConnection]/api_key_prefix`
  - added the new optional request property `agent_completions/anyOf[subschema #1]/items/mcp_config/anyOf[subschema #1: MCPConnection]/args`
  - added the new optional request property `agent_completions/anyOf[subschema #1]/items/mcp_config/anyOf[subschema #1: MCPConnection]/auth_type`
  - added the new optional request property `agent_completions/anyOf[subschema #1]/items/mcp_config/anyOf[subschema #1: MCPConnection]/command`
  - added the new optional request property `agent_completions/anyOf[subschema #1]/items/mcp_config/anyOf[subschema #1: MCPConnection]/env`
  - added the new optional request property `agent_completions/anyOf[subschema #1]/items/mcp_config/anyOf[subschema #1: MCPConnection]/name`
  - added the new optional request property `agent_completions/anyOf[subschema #1]/items/mcp_config/anyOf[subschema #1: MCPConnection]/oauth`
  - added the new optional request property `agent_completions/anyOf[subschema #1]/items/mcp_config/anyOf[subschema #1: MCPConnection]/sse_read_timeout`
  - added the new optional request property `agent_completions/anyOf[subschema #1]/items/mcp_config/anyOf[subschema #1: MCPConnection]/tool_timeout`
  - added the new optional request property `agent_completions/anyOf[subschema #1]/items/mcp_urls`
  - added the new optional request property `agent_completions/anyOf[subschema #1]/items/price_usd`
  - added the new optional request property `agent_completions/anyOf[subschema #1]/items/publish_to_marketplace`
  - added the new optional request property `agent_completions/anyOf[subschema #1]/items/selected_tools`
  - added the new optional request property `agent_completions/anyOf[subschema #1]/items/tags`
  - added the new optional request property `agent_completions/anyOf[subschema #1]/items/top_p`
  - added the new optional request property `agent_completions/anyOf[subschema #1]/items/use_cases`
  - added `#/components/schemas/MCPConnection, subschema #3` to the `agent_completions/anyOf[subschema #1]/items/mcp_url` request property `anyOf` list
  - added `subschema #1` to the `agent_completions/anyOf[subschema #1]/items/mcp_configs` request property `anyOf` list
  - …23 more

---

[Operation](https://skmtc.dev/the-swarm-corporation/apis/swarms-api/docs/v1/batched-grid-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/batched-grid-workflow/completions/post)