v3

latestOpenAPI 3.0.3raw.githubusercontent.com2026-04-279152.1 KB
Points

Upsert points

Insert or update points in a collection. If a point with the given ID already exists, it is overwritten. All points in the request are inserted or updated atomically.

put/collections/{collection_name}/points

Path parameters

collection_namestring required

The name of the collection to upsert points into.

Query parameters

waitboolean
Example:true

If true, the request blocks until all points are indexed. If false, returns immediately and indexing continues in the background. Defaults to true.

Request body

Example request

{
  "points": [
    {
      "vector": [
        0.1,
        0.2,
        0.3
      ],
      "payload": {
        "category": "A",
        "value": 100
      }
    }
  ]
}

Response

Points upserted successfully

timenumber double

Time spent to process this request, in seconds.

statusstring

Operation status. Returns ok on success.

Example response

{
  "time": 0.058295368,
  "status": "ok",
  "result": {
    "status": "Completed"
  }
}
All 9 operations