---
title: "Changes to Update collection cluster setup"
method: POST
path: "/collections/{collection_name}/cluster"
---

# Changes to Update collection cluster setup

`POST /collections/{collection_name}/cluster`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 8 of 20 revisions.

- **2026-10-22** `c93be9a86fe5`: 7 info
- **2026-08-05** `d08b1f613f29`: 1 breaking, 14 info
- **2026-05-20** `945e62a0043c`: 1 warning
- **2026-02-20** `26c6f383c006`: 1 info
- **2025-11-17** `d09f337ca2f3`: 12 breaking, 18 info
- **2025-04-15** `5d330acca4cd`: 2 breaking, 6 info
- **2025-01-17** `a7900f38a79d`: 8 info
- **2024-08-13** `d530ad1be7de`: 2 breaking, 2 info

## Changes

- **2026-10-22** `c93be9a86fe5`: 7 info
  - added `#/components/schemas/MatchSubstring` to the `anyOf[#/components/schemas/ReplicatePointsOperation]/replicate_points/filter/anyOf[#/components/schemas/Filter]/min_should/anyOf[#/components/schemas/MinShould]/conditions/items/anyOf[#/components/schemas/FieldCondition]/match/anyOf[#/components/schemas/Match]/` request property `anyOf` list
  - added `#/components/schemas/MatchSubstring` to the `anyOf[#/components/schemas/ReplicatePointsOperation]/replicate_points/filter/anyOf[#/components/schemas/Filter]/must/anyOf[#/components/schemas/Condition]/anyOf[#/components/schemas/FieldCondition]/match/anyOf[#/components/schemas/Match]/` request property `anyOf` list
  - added `#/components/schemas/MatchSubstring` to the `anyOf[#/components/schemas/ReplicatePointsOperation]/replicate_points/filter/anyOf[#/components/schemas/Filter]/must/anyOf[subschema #2]/items/anyOf[#/components/schemas/FieldCondition]/match/anyOf[#/components/schemas/Match]/` request property `anyOf` list
  - added `#/components/schemas/MatchSubstring` to the `anyOf[#/components/schemas/ReplicatePointsOperation]/replicate_points/filter/anyOf[#/components/schemas/Filter]/must_not/anyOf[#/components/schemas/Condition]/anyOf[#/components/schemas/FieldCondition]/match/anyOf[#/components/schemas/Match]/` request property `anyOf` list
  - added `#/components/schemas/MatchSubstring` to the `anyOf[#/components/schemas/ReplicatePointsOperation]/replicate_points/filter/anyOf[#/components/schemas/Filter]/must_not/anyOf[subschema #2]/items/anyOf[#/components/schemas/FieldCondition]/match/anyOf[#/components/schemas/Match]/` request property `anyOf` list
  - added `#/components/schemas/MatchSubstring` to the `anyOf[#/components/schemas/ReplicatePointsOperation]/replicate_points/filter/anyOf[#/components/schemas/Filter]/should/anyOf[#/components/schemas/Condition]/anyOf[#/components/schemas/FieldCondition]/match/anyOf[#/components/schemas/Match]/` request property `anyOf` list
  - added `#/components/schemas/MatchSubstring` to the `anyOf[#/components/schemas/ReplicatePointsOperation]/replicate_points/filter/anyOf[#/components/schemas/Filter]/should/anyOf[subschema #2]/items/anyOf[#/components/schemas/FieldCondition]/match/anyOf[#/components/schemas/Match]/` request property `anyOf` list
- **2026-08-05** `d08b1f613f29`: 1 breaking, 14 info
  - the `anyOf[#/components/schemas/ReplicatePointsOperation]/replicate_points/filter/anyOf[#/components/schemas/Filter]/min_should/anyOf[#/components/schemas/MinShould]/min_count` request property's min was increased to `1.00`
  - added `#/components/schemas/MatchPrefix` to the `anyOf[#/components/schemas/ReplicatePointsOperation]/replicate_points/filter/anyOf[#/components/schemas/Filter]/min_should/anyOf[#/components/schemas/MinShould]/conditions/items/anyOf[#/components/schemas/FieldCondition]/match/anyOf[#/components/schemas/Match]/` request property `anyOf` list
  - added `#/components/schemas/MatchPrefix` to the `anyOf[#/components/schemas/ReplicatePointsOperation]/replicate_points/filter/anyOf[#/components/schemas/Filter]/must/anyOf[#/components/schemas/Condition]/anyOf[#/components/schemas/FieldCondition]/match/anyOf[#/components/schemas/Match]/` request property `anyOf` list
  - added `#/components/schemas/MatchPrefix` to the `anyOf[#/components/schemas/ReplicatePointsOperation]/replicate_points/filter/anyOf[#/components/schemas/Filter]/must/anyOf[subschema #2]/items/anyOf[#/components/schemas/FieldCondition]/match/anyOf[#/components/schemas/Match]/` request property `anyOf` list
  - added `#/components/schemas/MatchPrefix` to the `anyOf[#/components/schemas/ReplicatePointsOperation]/replicate_points/filter/anyOf[#/components/schemas/Filter]/must_not/anyOf[#/components/schemas/Condition]/anyOf[#/components/schemas/FieldCondition]/match/anyOf[#/components/schemas/Match]/` request property `anyOf` list
  - added `#/components/schemas/MatchPrefix` to the `anyOf[#/components/schemas/ReplicatePointsOperation]/replicate_points/filter/anyOf[#/components/schemas/Filter]/must_not/anyOf[subschema #2]/items/anyOf[#/components/schemas/FieldCondition]/match/anyOf[#/components/schemas/Match]/` request property `anyOf` list
  - added `#/components/schemas/MatchPrefix` to the `anyOf[#/components/schemas/ReplicatePointsOperation]/replicate_points/filter/anyOf[#/components/schemas/Filter]/should/anyOf[#/components/schemas/Condition]/anyOf[#/components/schemas/FieldCondition]/match/anyOf[#/components/schemas/Match]/` request property `anyOf` list
  - added `#/components/schemas/MatchPrefix` to the `anyOf[#/components/schemas/ReplicatePointsOperation]/replicate_points/filter/anyOf[#/components/schemas/Filter]/should/anyOf[subschema #2]/items/anyOf[#/components/schemas/FieldCondition]/match/anyOf[#/components/schemas/Match]/` request property `anyOf` list
  - added `#/components/schemas/SliceCondition` to the `anyOf[#/components/schemas/ReplicatePointsOperation]/replicate_points/filter/anyOf[#/components/schemas/Filter]/min_should/anyOf[#/components/schemas/MinShould]/conditions/items/` request property `anyOf` list
  - added `#/components/schemas/SliceCondition` to the `anyOf[#/components/schemas/ReplicatePointsOperation]/replicate_points/filter/anyOf[#/components/schemas/Filter]/must/anyOf[#/components/schemas/Condition]/` request property `anyOf` list
  - added `#/components/schemas/SliceCondition` to the `anyOf[#/components/schemas/ReplicatePointsOperation]/replicate_points/filter/anyOf[#/components/schemas/Filter]/must/anyOf[subschema #2]/items/` request property `anyOf` list
  - added `#/components/schemas/SliceCondition` to the `anyOf[#/components/schemas/ReplicatePointsOperation]/replicate_points/filter/anyOf[#/components/schemas/Filter]/must_not/anyOf[#/components/schemas/Condition]/` request property `anyOf` list
  - added `#/components/schemas/SliceCondition` to the `anyOf[#/components/schemas/ReplicatePointsOperation]/replicate_points/filter/anyOf[#/components/schemas/Filter]/must_not/anyOf[subschema #2]/items/` request property `anyOf` list
  - added `#/components/schemas/SliceCondition` to the `anyOf[#/components/schemas/ReplicatePointsOperation]/replicate_points/filter/anyOf[#/components/schemas/Filter]/should/anyOf[#/components/schemas/Condition]/` request property `anyOf` list
  - added `#/components/schemas/SliceCondition` to the `anyOf[#/components/schemas/ReplicatePointsOperation]/replicate_points/filter/anyOf[#/components/schemas/Filter]/should/anyOf[subschema #2]/items/` request property `anyOf` list
- **2026-05-20** `945e62a0043c`: 1 warning
  - for the `query` request parameter `timeout`, the min was set to `1.00`
- **2026-02-20** `26c6f383c006`: 1 info
  - added the new `ManualRecovery` enum value to the request property `anyOf[#/components/schemas/CreateShardingKeyOperation]/create_sharding_key/initial_state/anyOf[#/components/schemas/ReplicaState]/`
- **2025-11-17** `d09f337ca2f3`: 12 breaking, 18 info
  - request property `anyOf[#/components/schemas/MoveShardOperation]/move_shard/method/anyOf[#/components/schemas/ShardTransferMethod]/` was restricted to a list of enum values
  - request property `anyOf[#/components/schemas/ReplicateShardOperation]/replicate_shard/method/anyOf[#/components/schemas/ShardTransferMethod]/` was restricted to a list of enum values
  - request property `anyOf[#/components/schemas/RestartTransferOperation]/restart_transfer/method` was restricted to a list of enum values
  - request property `anyOf[#/components/schemas/StartReshardingOperation]/start_resharding/direction` was restricted to a list of enum values
  - removed `subschema #1, subschema #2` from the `anyOf[#/components/schemas/StartReshardingOperation]/start_resharding/direction` request property `oneOf` list
  - removed `subschema #1, subschema #2, subschema #3, subschema #4` from the `anyOf[#/components/schemas/MoveShardOperation]/move_shard/method/anyOf[#/components/schemas/ShardTransferMethod]/` request property `oneOf` list
  - removed `subschema #1, subschema #2, subschema #3, subschema #4` from the `anyOf[#/components/schemas/ReplicateShardOperation]/replicate_shard/method/anyOf[#/components/schemas/ShardTransferMethod]/` request property `oneOf` list
  - removed `subschema #1, subschema #2, subschema #3, subschema #4` from the `anyOf[#/components/schemas/RestartTransferOperation]/restart_transfer/method` request property `oneOf` list
  - the `anyOf[#/components/schemas/MoveShardOperation]/move_shard/method/anyOf[#/components/schemas/ShardTransferMethod]/` request property type changed from no type to `string`
  - the `anyOf[#/components/schemas/ReplicateShardOperation]/replicate_shard/method/anyOf[#/components/schemas/ShardTransferMethod]/` request property type changed from no type to `string`
  - the `anyOf[#/components/schemas/RestartTransferOperation]/restart_transfer/method` request property type changed from no type to `string`
  - the `anyOf[#/components/schemas/StartReshardingOperation]/start_resharding/direction` request property type changed from no type to `string`
  - added the new optional request property `anyOf[#/components/schemas/CreateShardingKeyOperation]/create_sharding_key/initial_state`
  - added `#/components/schemas/ReplicatePointsOperation` to the request body `anyOf` list
  - added the new `down` enum value to the request property `anyOf[#/components/schemas/StartReshardingOperation]/start_resharding/direction`
  - added the new `resharding_stream_records` enum value to the request property `anyOf[#/components/schemas/MoveShardOperation]/move_shard/method/anyOf[#/components/schemas/ShardTransferMethod]/`
  - added the new `resharding_stream_records` enum value to the request property `anyOf[#/components/schemas/ReplicateShardOperation]/replicate_shard/method/anyOf[#/components/schemas/ShardTransferMethod]/`
  - added the new `resharding_stream_records` enum value to the request property `anyOf[#/components/schemas/RestartTransferOperation]/restart_transfer/method`
  - added the new `snapshot` enum value to the request property `anyOf[#/components/schemas/MoveShardOperation]/move_shard/method/anyOf[#/components/schemas/ShardTransferMethod]/`
  - added the new `snapshot` enum value to the request property `anyOf[#/components/schemas/ReplicateShardOperation]/replicate_shard/method/anyOf[#/components/schemas/ShardTransferMethod]/`
  - added the new `snapshot` enum value to the request property `anyOf[#/components/schemas/RestartTransferOperation]/restart_transfer/method`
  - added the new `stream_records` enum value to the request property `anyOf[#/components/schemas/MoveShardOperation]/move_shard/method/anyOf[#/components/schemas/ShardTransferMethod]/`
  - added the new `stream_records` enum value to the request property `anyOf[#/components/schemas/ReplicateShardOperation]/replicate_shard/method/anyOf[#/components/schemas/ShardTransferMethod]/`
  - added the new `stream_records` enum value to the request property `anyOf[#/components/schemas/RestartTransferOperation]/restart_transfer/method`
  - added the new `up` enum value to the request property `anyOf[#/components/schemas/StartReshardingOperation]/start_resharding/direction`
  - added the new `wal_delta` enum value to the request property `anyOf[#/components/schemas/MoveShardOperation]/move_shard/method/anyOf[#/components/schemas/ShardTransferMethod]/`
  - added the new `wal_delta` enum value to the request property `anyOf[#/components/schemas/ReplicateShardOperation]/replicate_shard/method/anyOf[#/components/schemas/ShardTransferMethod]/`
  - added the new `wal_delta` enum value to the request property `anyOf[#/components/schemas/RestartTransferOperation]/restart_transfer/method`
  - added `#/components/schemas/Usage` to the `usage` response property `anyOf` list for the response status `200`
  - removed `#/components/schemas/HardwareUsage` from the `usage` response property `anyOf` list for the response status `200`
- **2025-04-15** `5d330acca4cd`: 2 breaking, 6 info
  - removed the required property `usage/anyOf[#/components/schemas/HardwareUsage]/io_read` from the response with the `200` status
  - removed the required property `usage/anyOf[#/components/schemas/HardwareUsage]/io_write` from the response with the `200` status
  - added the required property `usage/anyOf[#/components/schemas/HardwareUsage]/payload_index_io_read` to the response with the `200` status
  - added the required property `usage/anyOf[#/components/schemas/HardwareUsage]/payload_index_io_write` to the response with the `200` status
  - added the required property `usage/anyOf[#/components/schemas/HardwareUsage]/payload_io_read` to the response with the `200` status
  - added the required property `usage/anyOf[#/components/schemas/HardwareUsage]/payload_io_write` to the response with the `200` status
  - added the required property `usage/anyOf[#/components/schemas/HardwareUsage]/vector_io_read` to the response with the `200` status
  - added the required property `usage/anyOf[#/components/schemas/HardwareUsage]/vector_io_write` to the response with the `200` status
- **2025-01-17** `a7900f38a79d`: 8 info
  - api tag `Distributed` added
  - api tag `cluster` removed
  - api tag `collections` removed
  - added `#/components/schemas/StartReshardingOperation, #/components/schemas/AbortReshardingOperation` to the request body `anyOf` list
  - added `subschema #4` to the `anyOf[#/components/schemas/MoveShardOperation]/move_shard/method/anyOf[#/components/schemas/ShardTransferMethod]/` request property `oneOf` list
  - added `subschema #4` to the `anyOf[#/components/schemas/ReplicateShardOperation]/replicate_shard/method/anyOf[#/components/schemas/ShardTransferMethod]/` request property `oneOf` list
  - added `subschema #4` to the `anyOf[#/components/schemas/RestartTransferOperation]/restart_transfer/method` request property `oneOf` list
  - added the optional property `usage` to the response with the `200` status
- **2024-08-13** `d530ad1be7de`: 2 breaking, 2 info
  - removed `subschema #1, subschema #2` from the `anyOf[#/components/schemas/CreateShardingKeyOperation]/create_sharding_key/shard_key` request property `anyOf` list
  - removed `subschema #1, subschema #2` from the `anyOf[#/components/schemas/DropShardingKeyOperation]/drop_sharding_key/shard_key` request property `anyOf` list
  - added `subschema #1, subschema #2` to the `anyOf[#/components/schemas/CreateShardingKeyOperation]/create_sharding_key/shard_key` request property `anyOf` list
  - added `subschema #1, subschema #2` to the `anyOf[#/components/schemas/DropShardingKeyOperation]/drop_sharding_key/shard_key` request property `anyOf` list

---

[Operation](https://skmtc.dev/qdrant/apis/qdrant-api/docs/collections/:collection_name/cluster/post.md) - [API](https://skmtc.dev/qdrant/apis/qdrant-api.md) - [Page](https://skmtc.dev/qdrant/apis/qdrant-api/changes/collections/:collection_name/cluster/post)
