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

This endpoint returns an object.

usageobject or anyOptional

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

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