Overwrite payload | Qdrant

# Overwrite payload by ID
curl  -X PUT \
  'http://localhost:6333/collections/collection_name/points/payload' \
  --header 'api-key: <api-key-value>' \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "payload": {
    "property1": "string",
    "property2": "string"
  },
  "points": [
    0,
    3,
    10
  ]
}'
# Overwrite payload by filter
curl  -X PUT \
  'http://localhost:6333/collections/collection_name/points/payload' \
  --header 'api-key: <api-key-value>' \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "payload": {
    "property1": "string",
    "property2": "string"
  },
  "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
  }
}

Replaces the entire payload of a specified point with a new payload.

Authentication

api-keystring

API Key authentication via header

Path parameters

collection_namestringRequired

Name of the collection to set from

Query parameters

waitbooleanOptional

If true, wait for changes to actually happen

orderingenumOptional

define ordering guarantees for the operation

Allowed values:

Request

Payload and points selector

payloadmap from strings to anyRequired

pointslist of uint64s or strings or nullOptional

Assigns payload to each point in this list

filterobject or anyOptional

Assigns payload to each point that satisfy this filter condition

shard_keystring or uint64 or list of strings or uint64s or anyOptional

keystring or nullOptional

Assigns payload to each point that satisfy this path of property

Response

successful operation

usageobject or any

timedouble

Time spent to process this request

statusstring

resultobject