---
title: "Upsert points"
method: PUT
path: "/collections/{collection_name}/points"
tags: ["Points"]
---

# Upsert points

`PUT /collections/{collection_name}/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.

## Path parameters

- `collection_name` string, required

## Query parameters

- `wait` boolean

## Request body

- object
  - `points` object[], required — Array of point objects to insert or update.
    - `id` union, required — Unique identifier for the point. Accepts an integer or a UUID string.
      - integer
      - string
    - `vector` number[], required — The dense vector embedding for this point. The number of dimensions must match the collection's configured vector size.
    - `payload` object — Optional JSON metadata associated with the point. Can contain any valid JSON object with nested fields.

## Response `200`

Points upserted successfully

- object
  - `usage` object — Resource usage information for this request.
    - `hardware` object, nullable — Hardware resource counters for the operation, including CPU, payload I/O, payload index I/O, and vector I/O metrics.
  - `time` number, double — Time spent to process this request, in seconds.
  - `status` string — Operation status. Returns `ok` on success.
  - `result` object — Operation result containing the status of the upsert.
    - `operation_id` integer — Unique identifier for the operation.
    - `status` string — Status of the operation. Returns `Completed` when the operation finishes successfully.

## Other responses

- `4XX` — Error response

---

[API](https://skmtc.dev/actiancorp/apis/actian-vectorai-db-points-api.md) · [All operations](https://skmtc.dev/actiancorp/apis/actian-vectorai-db-points-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/actiancorp/actian-vectorai-db-points-api/revisions/a1f393eb2a41/schema)