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

# Upsert points

`PUT /collections/{collection_name}/points`

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

## Path parameters

- `collection_name` string, required

## Query parameters

- `wait` boolean
- `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

## Request body

- union
  - PointsBatch
    - `batch` Batch, required
      - `ids` ExtendedPointId[], required
        - union — Type, used for specifying point ID in user interface
          - integer
          - string, uuid
      - `vectors` union, required
        - array[]
          - number[]
        - array[]
          - array[]
            - number[]
        - object
        - Document[]
          - `text` string, required — Text of the document This field will be used as input for the embedding model
          - `model` string, required — Name of the model used to generate the vector List of available models depends on a provider
          - `options` object, nullable — Parameters for the model Values of the parameters are model-specific
        - Image[]
          - `image` string, required — Image data: base64 encoded image or an URL
          - `model` string, required — Name of the model used to generate the vector List of available models depends on a provider
          - `options` object, nullable — Parameters for the model Values of the parameters are model-specific
        - InferenceObject[]
          - `object` unknown, required
          - `model` string, required — Name of the model used to generate the vector List of available models depends on a provider
          - `options` object, nullable — Parameters for the model Values of the parameters are model-specific
      - `payloads` union[], nullable
        - union
          - Payload
          - unknown
    - `shard_key` union
      - union
        - union
          - string
          - integer
        - ShardKey[]
          - union
            - string
            - integer
      - unknown
  - PointsList
    - `points` PointStruct[], required
      - `id` union, required — Type, used for specifying point ID in user interface
        - integer
        - string, uuid
      - `vector` union, required — Full vector data per point separator with single and multiple vector modes
        - number[]
        - array[]
          - number[]
        - object
        - Document — WARN: Work-in-progress, unimplemented Text document for embedding. Requires inference infrastructure, unimplemented.
          - `text` string, required — Text of the document This field will be used as input for the embedding model
          - `model` string, required — Name of the model used to generate the vector List of available models depends on a provider
          - `options` object, nullable — Parameters for the model Values of the parameters are model-specific
        - Image — WARN: Work-in-progress, unimplemented Image object for embedding. Requires inference infrastructure, unimplemented.
          - `image` string, required — Image data: base64 encoded image or an URL
          - `model` string, required — Name of the model used to generate the vector List of available models depends on a provider
          - `options` object, nullable — Parameters for the model Values of the parameters are model-specific
        - InferenceObject — WARN: Work-in-progress, unimplemented Custom object for embedding. Requires inference infrastructure, unimplemented.
          - `object` unknown, required
          - `model` string, required — Name of the model used to generate the vector List of available models depends on a provider
          - `options` object, nullable — Parameters for the model Values of the parameters are model-specific
      - `payload` union — Payload values (optional)
        - Payload
        - unknown
    - `shard_key` union
      - union
        - union
          - string
          - integer
        - ShardKey[]
          - union
            - string
            - integer
      - unknown

## Response `200`

successful operation

- object
  - `usage` union
    - HardwareUsage — Usage of the hardware resources, spent to process the request
      - `cpu` integer, required
      - `payload_io_read` integer, required
      - `payload_io_write` integer, required
      - `payload_index_io_read` integer, required
      - `payload_index_io_write` integer, required
      - `vector_io_read` integer, required
      - `vector_io_write` integer, required
    - unknown
  - `time` number, float — Time spent to process this request
  - `status` string
  - `result` UpdateResult
    - `operation_id` integer, nullable — Sequential number of the operation
    - `status` 'acknowledged' | 'completed', required — `Acknowledged` - Request is saved to WAL and will be process in a queue. `Completed` - Request is completed, changes are actual.

## Other responses

- `default` — error
- `4XX` — error

## Changes

- **2025-04-15** `5d330acca4cd` — 2 breaking, 6 info
  - removed the required property `usage/anyOf[#/components/schemas/HardwareUsage]/io_read` from the response with the `200` status
  - removed the required property `usage/anyOf[#/components/schemas/HardwareUsage]/io_write` from the response with the `200` status
  - added the required property `usage/anyOf[#/components/schemas/HardwareUsage]/payload_index_io_read` to the response with the `200` status
  - added the required property `usage/anyOf[#/components/schemas/HardwareUsage]/payload_index_io_write` to the response with the `200` status
  - …4 more
- **2025-01-17** `a7900f38a79d` — 7 breaking, 8 info
  - removed `subschema #3, subschema #4` from the `anyOf[#/components/schemas/PointsBatch]/batch/vectors` request property `anyOf` list
  - the request property `anyOf[#/components/schemas/PointsList]/points/items/vector/anyOf[#/components/schemas/Document]/model` became not nullable
  - the request property `anyOf[#/components/schemas/PointsList]/points/items/vector/anyOf[subschema #3]/additionalProperties/anyOf[#/components/schemas/Document]/model` became not nullable
  - the request property `anyOf[#/components/schemas/PointsList]/points/items/vector/anyOf[#/components/schemas/Document]/model` became required
  - …11 more
- …earlier changes not shown

[Full history](https://skmtc.dev/qdrant/apis/qdrant-api/changes/collections/:collection_name/points/put.md)

---

[API](https://skmtc.dev/qdrant/apis/qdrant-api.md) · [All operations](https://skmtc.dev/qdrant/apis/qdrant-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/qdrant/qdrant-api/revisions/5d330acca4cd/schema)