Sign in
Points

Upsert points

Perform insert + updates on points. If point with given ID already exists - it will be overwritten.

put/collections/{collection_name}/points

Path parameters

collection_namestring required

Name of the collection to update from

Query parameters

waitboolean

If true, wait for changes to actually happen

ordering'weak' | 'medium' | 'strong'

Defines write ordering guarantees for collection operations

  • weak - write operations may be reordered, works faster, default

  • medium - write operations go through dynamically selected leader, may be inconsistent for a short period of time in case of leader change

  • strong - Write operations go through the permanent leader, consistent, but may be unavailable if leader is down

define ordering guarantees for the operation

Request body

OR

Example request

{
  "batch": {
    "ids": [
      42
    ],
    "vectors": [
      {
        "text": "This is a document text",
        "model": "jinaai/jina-embeddings-v2-base-en"
      }
    ],
    "payloads": [
      {
        "city": "London",
        "color": "green"
      }
    ]
  },
  "shard_key": "region_1"
}

Response

successful operation

timenumber float

Time spent to process this request

statusstring

Example response

{
  "time": 0.002,
  "status": "ok"
}

Changes