Upsert points | Qdrant | API Reference

curl  -X PUT \
  'http://localhost:6333/collections/collection_name/points' \
  --header 'api-key: <api-key-value>' \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "points": [
    {
      "id": "76874cce-1fb9-4e16-9b0b-f085ac06ed6f",
      "payload": {
        "color": "red"
      },
      "vector": [
        0.9,
        0.1,
        0.1
      ]
    },
    {
      "id": 1,
      "payload": {
        "color": "green"
      },
      "vector": [
        0.1,
        0.9,
        0.1
      ]
    },
    {
      "id": 2,
      "payload": {
        "color": "blue"
      },
      "vector": [
        0.1,
        0.1,
        0.9
      ]
    }
  ]
}'

{
  "time": 0.002,
  "status": "ok",
  "result": {
    "status": "acknowledged",
    "operation_id": 1
  }
}

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

timedouble

Time spent to process this request

statusstring

resultobject

$	curl -X PUT \
>	'http://localhost:6333/collections/collection_name/points' \
>	--header 'api-key: <api-key-value>' \
>	--header 'Content-Type: application/json' \
>	--data-raw '{
>	"points": [
>	{
>	"id": "76874cce-1fb9-4e16-9b0b-f085ac06ed6f",
>	"payload": {
>	"color": "red"
>	},
>	"vector": [
>	0.9,
>	0.1,
>	0.1
>	]
>	},
>	{
>	"id": 1,
>	"payload": {
>	"color": "green"
>	},
>	"vector": [
>	0.1,
>	0.9,
>	0.1
>	]
>	},
>	{
>	"id": 2,
>	"payload": {
>	"color": "blue"
>	},
>	"vector": [
>	0.1,
>	0.1,
>	0.9
>	]
>	}
>	]
>	}'

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