Distributed

Remove peer from the cluster

Tries to remove peer from the cluster. Will return an error if peer has shards on it.

delete/cluster/peer/{peer_id}

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/cluster/peer/:peer_id/delete.ts
A function with typed inputs. Its response is checked against the schema.

peer_idinteger required

Id of the peer

timeoutinteger

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

forceboolean

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

successful operation

timenumber float

Time spent to process this request

statusstring

resultboolean

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

May 20, 2026945e62a0043c Revision changes
- warning
  for the query request parameter timeout, the min was set to 1.00
Nov 17, 2025d09f337ca2f3 Revision changes
- info
  added the new optional query request parameter timeout
- info
  added to the response property anyOf list for the response status
- info
  removed from the response property anyOf list for the response status