---
title: "Changes to Execute Reasoning Agent Completion"
method: POST
path: "/v1/reasoning-agent/completions"
---

# Changes to Execute Reasoning Agent Completion

`POST /v1/reasoning-agent/completions`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 2 of 54 revisions.

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

## Changes

- **2026-10-31** `3e13975ede3d`: 1 breaking, 2 warning
  - request property `num_samples` list-of-types was narrowed by removing types `null` from media type `application/json`
  - the `num_samples` request property's max was set to `2000.00`
  - the `num_samples` request property's min was set to `1.00`
- **2026-10-16** `500c79520e41`: 3 breaking, 3 warning, 17 info
  - request property `swarm_type` was restricted to a list of enum values
  - removed the enum value `xml` of the request property `output_type/anyOf[subschema #1]/`
  - request property `swarm_type` list-of-types was narrowed by removing types `null` from media type `application/json`
  - the `max_loops/anyOf[subschema #1]/` request property's max was set to `50.00`
  - the `max_loops/anyOf[subschema #1]/` request property's min was set to `1.00`
  - removed the request property `num_knowledge_items`
  - api tag `Reasoning Agents` added
  - the `model_name` request property default value changed from `claude-sonnet-4-20250514` to `claude-sonnet-5`
  - the `swarm_type` request property default value changed from `reasoning_duo` to `self-consistency`
  - added the new `AgentJudge` enum value to the request property `swarm_type`
  - added the new `ReflexionAgent` enum value to the request property `swarm_type`
  - added the new `consistency-agent` enum value to the request property `swarm_type`
  - added the new `self-consistency` enum value to the request property `swarm_type`
  - 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
  - added the optional property `status` to the response with the `200` status
  - added the required property `agent_id` to the response with the `200` status
  - added the required property `agent_name` to the response with the `200` status
  - added the required property `agent_type` to the response with the `200` status
  - added the required property `job_id` to the response with the `200` status
  - added the required property `outputs` to the response with the `200` status
  - added the required property `timestamp` to the response with the `200` status
  - added the required property `usage` to the response with the `200` status

---

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