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 "io_read": 1, 5 "io_write": 1 6 }, 7 "time": 0.002, 8 "status": "ok", 9 "result": { 10 "status": "acknowledged", 11 "operation_id": 1 12 } 13 }

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

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

This endpoint expects an object.

Points BatchobjectRequired

Points ListobjectRequired

Response

This endpoint returns an object.

usageobject or anyOptional

timedoubleOptional

Time spent to process this request

statusstringOptional

resultobjectOptional

Path parameters

Headers

Query parameters

Request

Response