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

# Update vectors

`PUT /collections/{collection_name}/points/vectors`

Update specified named vectors on points, keep unspecified vectors intact.

## 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

- UpdateVectors
  - `points` PointVectors[], required — Points with named vectors
    - `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, nullable — Name of the model used to generate the vector List of available models depends on a provider
  - `shard_key` union
    - union
      - union
        - string
        - integer
      - ShardKey[]
        - union
          - string
          - integer
    - unknown

## Response `200`

successful operation

- object
  - `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

- **2024-09-09** `99f8ca65a207` — 2 info
  - added `#/components/schemas/Document` to the `points/items/vector` request property `anyOf` list
  - added `#/components/schemas/Document` to the `points/items/vector/anyOf[subschema #3]/additionalProperties/` request property `anyOf` list
- **2024-08-13** `d530ad1be7de` — 4 breaking, 4 info
  - removed `subschema #1, subschema #2` from the `points/items/id` request property `anyOf` list
  - removed `subschema #1, subschema #2` from the `shard_key/anyOf[#/components/schemas/ShardKeySelector]/anyOf[#/components/schemas/ShardKey]/` request property `anyOf` list
  - removed `subschema #1, subschema #2` from the `shard_key/anyOf[#/components/schemas/ShardKeySelector]/anyOf[subschema #2]/items/` request property `anyOf` list
  - removed `subschema #1, subschema #2, subschema #3` from the `points/items/vector` request property `anyOf` list
  - …4 more
- **2024-07-01** `e1a916176c14` — 1 info
  - added `subschema #2` to the `points/items/vector` request property `anyOf` list

[Change history](https://skmtc.dev/qdrant/apis/qdrant-api/changes/collections/:collection_name/points/vectors/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/99f8ca65a207/schema)