Batch update points

POST

Batch updates points, including their respective vectors and payloads.

Path parameters

collection_namestringRequired

Name of the collection to apply operations on

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.

operationslist of objectsRequired

Response

This endpoint returns an object.

usageobject or anyOptional

timedoubleOptional

Time spent to process this request

statusstringOptional

resultlist of objectsOptional

POST

1 curl  -X POST \
2   'http://localhost:6333/collections/collection_name/points/batch' \
3   --header 'Content-Type: application/json' \
4   --header 'api-key: <api-key-value>' \
5   --data-raw '{
6   "operations": [
7     {
8       "upsert": {
9         "points": [
10           {
11             "id": 1,
12             "vector": [
13               0.4,
14               0.3,
15               0.2,
16               0.1
17             ]
18           }
19         ]
20       }
21     },
22     {
23       "update_vectors": {
24         "points": [
25           {
26             "id": 1,
27             "vector": [
28               0.11,
29               0.22,
30               0.33,
31               0.44
32             ]
33           }
34         ]
35       }
36     },
37     {
38       "set_payload": {
39         "payload": {
40           "test_payload_2": 2,
41           "test_payload_3": 3
42         },
43         "points": [
44           1
45         ]
46       }
47     }
48   ]
49 }'

200Successful

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     {
11       "status": "acknowledged",
12       "operation_id": 1
13     }
14   ]
15 }

Scroll points

Up Next

Built with

1	curl -X POST \
2	'http://localhost:6333/collections/collection_name/points/batch' \
3	--header 'Content-Type: application/json' \
4	--header 'api-key: <api-key-value>' \
5	--data-raw '{
6	"operations": [
7	{
8	"upsert": {
9	"points": [
10	{
11	"id": 1,
12	"vector": [
13	0.4,
14	0.3,
15	0.2,
16	0.1
17	]
18	}
19	]
20	}
21	},
22	{
23	"update_vectors": {
24	"points": [
25	{
26	"id": 1,
27	"vector": [
28	0.11,
29	0.22,
30	0.33,
31	0.44
32	]
33	}
34	]
35	}
36	},
37	{
38	"set_payload": {
39	"payload": {
40	"test_payload_2": 2,
41	"test_payload_3": 3
42	},
43	"points": [
44	1
45	]
46	}
47	}
48	]
49	}'

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	{
11	"status": "acknowledged",
12	"operation_id": 1
13	}
14	]
15	}