Upsert points

PUT

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: weakmediumstrong

Request

This endpoint expects an object.

Points Batchobject

Points Listobject

Response

successful operation

timedoubleOptional

Time spent to process this request

statusstringOptional

resultobjectOptional

PUT

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 }'

200Updated

1 {
2   "time": 0.002,
3   "status": "ok",
4   "result": {
5     "status": "acknowledged",
6     "operation_id": 1000000
7   }
8 }

Retrieve a point

Up Next

Built with

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	"time": 0.002,
3	"status": "ok",
4	"result": {
5	"status": "acknowledged",
6	"operation_id": 1000000
7	}
8	}