Distributed

Update collection cluster setup

Changed on Oct 22, 2026

post/collections/{collection_name}/cluster

Request

Base URL
http://localhost:6333
Auth
- API key in header api-key
- or HTTP bearer
- or none
TypeScript
https://skmtc.dev/qdrant/apis/qdrant-api/docs/collections/:collection_name/cluster/post.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

collection_namestring required

Name of the collection on which to to apply the cluster update operation

Query parameters

timeoutinteger

Wait for operation commit timeout in seconds. If timeout is reached - request will return with service error.

Request body

Example request

{
  "create_sharding_key": {
    "shard_key": "region_1"
  }
}

Response

successful operation

timenumber float

Time spent to process this request

statusstring

resultboolean

Example response

{
  "time": 0.002,
  "status": "ok"
}

Changes

Oct 22, 2026c93be9a86fe5 Revision changes
- info
  added to the ///////////////////////// request property anyOf list
- info
  added to the /////////////////////// request property anyOf list
- info
  added to the ///////////////////// request property anyOf list
- info
  added to the /////////////////////// request property anyOf list
- info
  added to the ///////////////////// request property anyOf list
- info
  added to the /////////////////////// request property anyOf list
- info
  added to the ///////////////////// request property anyOf list
Aug 5, 2026d08b1f613f29 Revision changes
- breaking
  the /////////////// request property's min was increased to 1.00
- info
  added to the ///////////////////////// request property anyOf list
- info
  added to the /////////////////////// request property anyOf list
- info
  added to the ///////////////////// request property anyOf list
- info
  added to the /////////////////////// request property anyOf list
- info
  added to the ///////////////////// request property anyOf list
- info
  added to the /////////////////////// request property anyOf list
- info
  added to the ///////////////////// request property anyOf list
- info
  added to the //////////////// request property anyOf list
- info
  added to the ////////////// request property anyOf list
- info
  added to the //////////// request property anyOf list
- info
  added to the ////////////// request property anyOf list
- info
  added to the //////////// request property anyOf list
- info
  added to the ////////////// request property anyOf list
- info
  added to the //////////// request property anyOf list

Operation history (8 revisions)