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
      • POSTRetrieve points
      • PUTUpsert points
      • GETRetrieve a point
      • POSTDelete points
      • PUTUpdate vectors
      • POSTDelete vectors
      • POSTSet payload
      • PUTOverwrite payload
      • POSTDelete payload
      • POSTClear payload
      • POSTBatch update points
      • POSTScroll points
      • POSTCount points
      • POSTPayload field facets
LogoLogo
CloudGitHub
API ReferencePoints

Delete points

POST
/collections/:collection_name/points/delete
POST
/collections/:collection_name/points/delete
$# Delete points by IDs
$curl  -X POST \
>  'http://localhost:6333/collections/collection_name/points/delete' \
>  --header 'api-key: <api-key-value>' \
>  --header 'Content-Type: application/json' \
>  --data-raw '{
>  "points": [
>    0,
>    3,
>    100
>  ]
>}'
$
$# Delete points by filter 
$curl  -X POST \
>  'http://localhost:6333/collections/collection_name/points/delete' \
>  --header 'api-key: <api-key-value>' \
>  --header 'Content-Type: application/json' \
>  --data-raw '{
>  "filter": {
>    "must": [
>      {
>        "key": "color",
>        "match": {
>          "value": "red"
>        }
>      }
>    ]
>  }
>}'
200Successful
1{
2  "usage": {
3    "cpu": 1,
4    "payload_io_read": 1,
5    "payload_io_write": 1,
6    "payload_index_io_read": 1,
7    "payload_index_io_write": 1,
8    "vector_io_read": 1,
9    "vector_io_write": 1
10  },
11  "time": 0.002,
12  "status": "ok",
13  "result": {
14    "status": "acknowledged",
15    "operation_id": 1
16  }
17}
Deletes specified points from the collection.
Was this page helpful?
Previous

Update vectors

Next
Built with

Authentication

api-keystring
API Key authentication via header

Path parameters

collection_namestringRequired
Name of the collection to delete from

Query parameters

waitbooleanOptional
If true, wait for changes to actually happen
orderingenumOptional
define ordering guarantees for the operation
Allowed values:

Request

Operation to perform on points
PointIdsListobjectRequired
OR
FilterSelectorobjectRequired

Response

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