---
title: "Changes to Execute Swarm Completion"
method: POST
path: "/v1/swarm/completions"
---

# Changes to Execute Swarm Completion

`POST /v1/swarm/completions`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 2 of 54 revisions.

- **2026-11-02** `fca99f497199`: 1 breaking, 1 info
- **2026-10-16** `500c79520e41`: 9 breaking, 7 warning, 64 info

## Changes

- **2026-11-02** `fca99f497199`: 1 breaking, 1 info
  - removed `subschema #1` from the `director_settings` request property `anyOf` list
  - added `#/components/schemas/DirectorSettings` to the `director_settings` request property `anyOf` list
- **2026-10-16** `500c79520e41`: 9 breaking, 7 warning, 64 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
  - removed the enum value `AutoSwarmBuilder` of the request property `swarm_type/anyOf[subschema #1]/`
  - removed the enum value `DeepResearchSwarm` of the request property `swarm_type/anyOf[subschema #1]/`
  - removed the enum value `HiearchicalSwarm` of the request property `swarm_type/anyOf[subschema #1]/`
  - removed the enum value `InteractiveGroupChat` of the request property `swarm_type/anyOf[subschema #1]/`
  - removed the enum value `MALT` of the request property `swarm_type/anyOf[subschema #1]/`
  - removed the enum value `auto` of the request property `swarm_type/anyOf[subschema #1]/`
  - removed the required property `service_tier` 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 `max_loops/anyOf[subschema #1]/` request property's max was set to `50.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`
  - removed the request property `heavy_swarm_loops_per_agent`
  - removed the request property `rules`
  - removed the request property `service_tier`
  - api tag `Swarms` added
  - 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`
  - …40 more

---

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