For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
CloudGitHub
  • API Reference
      • GETCheck cluster status
      • PUTCreate a shard key
      • POSTDelete a shard key
      • POSTRecover cluster state
      • DELRemove peer from cluster
      • GETRetrieve cluster details
      • POSTUpdate cluster setup
LogoLogo
CloudGitHub
API ReferenceDistributed

Delete a shard key

POST
/collections/:collection_name/shards/delete
POST
/collections/:collection_name/shards/delete
$curl -X POST http://localhost:6333/collections/collection_name/shards/delete \
>     -H "api-key: <apiKey>" \
>     -H "Content-Type: application/json" \
>     -d '{
>  "shard_key": "string"
>}'
200Successful
1{
2  "time": 1.1,
3  "status": "string",
4  "result": true
5}
Deletes one or more shard keys for a specified collection.
Was this page helpful?
Previous

Recover cluster state

Next
Built with

Authentication

api-keystring
API Key authentication via header

Path parameters

collection_namestringRequired
Name of the collection to create shards for

Query parameters

timeoutintegerOptional

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

Request

Select shard key to delete
shard_keystring or uint64Required

Response

successful operation
timedouble
Time spent to process this request
statusstring
resultboolean