Delete payload | Qdrant | API Reference

# Delete payload by ID
curl  -X POST \
  'http://localhost:6333/collections/collection_name/points/payload/delete' \
  --header 'api-key: <api-key-value>' \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "keys": [
    "color",
    "price"
  ],
  "points": [
    0,
    3,
    100
  ]
}'
# Delete payload by filter
curl  -X POST \
  'http://localhost:6333/collections/collection_name/points/payload/delete' \
  --header 'api-key: <api-key-value>' \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "keys": [
    "color",
    "price"
  ],
  "filter": {
    "must": [
      {
        "key": "color",
        "match": {
          "value": "red"
        }
      }
    ]
  }
}'

{
  "usage": {
    "cpu": 1,
    "payload_io_read": 1,
    "payload_io_write": 1,
    "payload_index_io_read": 1,
    "payload_index_io_write": 1,
    "vector_io_read": 1,
    "vector_io_write": 1
  },
  "time": 0.002,
  "status": "ok",
  "result": {
    "status": "acknowledged",
    "operation_id": 1
  }
}

# Delete payload by ID
curl  -X POST \
  'http://localhost:6333/collections/collection_name/points/payload/delete' \
  --header 'api-key: <api-key-value>' \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "keys": [
    "color",
    "price"
  ],
  "points": [
    0,
    3,
    100
  ]
}'
# Delete payload by filter
curl  -X POST \
  'http://localhost:6333/collections/collection_name/points/payload/delete' \
  --header 'api-key: <api-key-value>' \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "keys": [
    "color",
    "price"
  ],
  "filter": {
    "must": [
      {
        "key": "color",
        "match": {
          "value": "red"
        }
      }
    ]
  }
}'

{
  "usage": {
    "cpu": 1,
    "payload_io_read": 1,
    "payload_io_write": 1,
    "payload_index_io_read": 1,
    "payload_index_io_write": 1,
    "vector_io_read": 1,
    "vector_io_write": 1
  },
  "time": 0.002,
  "status": "ok",
  "result": {
    "status": "acknowledged",
    "operation_id": 1
  }
}

Deletes a specified key payload for points.

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

delete payload on points

keyslist of stringsRequired

List of payload keys to remove from payload

pointslist of uint64s or strings or nullOptional

Deletes values from each point in this list

filterobject or anyOptional

Deletes values from points that satisfy this filter condition

shard_keystring or uint64 or list of strings or uint64s or anyOptional

Response

successful operation

usageobject or any

timedouble

Time spent to process this request

statusstring

resultobject

$	# Delete payload by ID
$	curl -X POST \
>	'http://localhost:6333/collections/collection_name/points/payload/delete' \
>	--header 'api-key: <api-key-value>' \
>	--header 'Content-Type: application/json' \
>	--data-raw '{
>	"keys": [
>	"color",
>	"price"
>	],
>	"points": [
>	0,
>	3,
>	100
>	]
>	}'
$
$	# Delete payload by filter
$	curl -X POST \
>	'http://localhost:6333/collections/collection_name/points/payload/delete' \
>	--header 'api-key: <api-key-value>' \
>	--header 'Content-Type: application/json' \
>	--data-raw '{
>	"keys": [
>	"color",
>	"price"
>	],
>	"filter": {
>	"must": [
>	{
>	"key": "color",
>	"match": {
>	"value": "red"
>	}
>	}
>	]
>	}
>	}'

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	}