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

Remove peer from cluster

DELETE
/cluster/peer/:peer_id
DELETE
/cluster/peer/:peer_id
$curl -X DELETE http://localhost:6333/cluster/peer/1 \
>     -H "api-key: <apiKey>"
200Deleted
1{
2  "usage": {
3    "cpu": 1,
4    "io_read": 1,
5    "io_write": 1
6  },
7  "time": 0.002,
8  "status": "ok",
9  "result": true
10}

Attempts to remove the node from the cluster. This endpoint returns an error if the node (peer) has shards on it.

Was this page helpful?
Previous

Retrieve cluster details

Next
Built with

Authentication

api-keystring
API Key authentication via header

Path parameters

peer_idintegerRequired
Id of the peer

Query parameters

forcebooleanOptionalDefaults to false

If true - removes peer even if it has shards/replicas on it.

Response

successful operation
usageobject or any
timedouble
Time spent to process this request
statusstring
resultboolean