Upsert points | Qdrant | API Reference

1 curl -X PUT \ 2 'http://localhost:6333/collections/collection_name/points' \ 3 --header 'api-key: <api-key-value>' \ 4 --header 'Content-Type: application/json' \ 5 --data-raw '{ 6 "points": [ 7 { 8 "id": "76874cce-1fb9-4e16-9b0b-f085ac06ed6f", 9 "payload": { 10 "color": "red" 11 }, 12 "vector": [ 13 0.9, 14 0.1, 15 0.1 16 ] 17 }, 18 { 19 "id": 1, 20 "payload": { 21 "color": "green" 22 }, 23 "vector": [ 24 0.1, 25 0.9, 26 0.1 27 ] 28 }, 29 { 30 "id": 2, 31 "payload": { 32 "color": "blue" 33 }, 34 "vector": [ 35 0.1, 36 0.1, 37 0.9 38 ] 39 } 40 ] 41 }'

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 }

Performs the insert + update action on specified points. Any point with an existing {id} will be overwritten.

Authentication

api-keystring

API Key authentication via header

Path parameters

collection_namestringRequired

Name of the collection to update 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

PointsBatchobjectRequired

PointsListobjectRequired

Response

successful operation

usageobject or any or null

timedouble or null

Time spent to process this request

statusstring or null

resultobject or null