---
title: "Create named vector"
method: PUT
path: "/collections/{collection_name}/vectors/{vector_name}"
tags: ["Collections"]
---

# Create named vector

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

Create a new named vector on an existing collection

## Path parameters

- `collection_name` string, required
- `vector_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
- `timeout` integer

## Request body

- union — Configuration for creating a new named vector. Contains only the immutable properties that define a vector space. Storage type, index, and quantization are determined automatically based on the segment type and can be configured separately later. Example JSON for a dense vector: ```json { "dense": { "size": 768, "distance": "Cosine" } } ``` Example JSON for a sparse vector: ```json { "sparse": { "modifier": "Idf" } } ```
  - DenseVectorNameConfig — Wrapper for dense vector creation config.
    - `dense` DenseVectorConfig, required — Configuration for creating a new dense named vector. Only includes properties that define the vector space and cannot be changed after creation. Storage type, index type, and quantization are inferred.
      - `size` integer, required — Dimensionality of the vectors
      - `distance` 'Cosine' | 'Euclid' | 'Dot' | 'Manhattan', required — Type of internal tags, build from payload Distance function types used to compare vectors
      - `multivector_config` union — Configuration for multi-vector points (e.g., ColBERT)
        - MultiVectorConfig
          - `comparator` 'max_sim', required
        - unknown
      - `datatype` union — Element storage type (Float32, Float16, Uint8, Turbo4)
        - 'float32' | 'float16' | 'uint8' | 'turbo4' — Storage types for vectors
        - unknown
  - SparseVectorNameConfig — Wrapper for sparse vector creation config.
    - `sparse` SparseVectorConfig, required — Configuration for creating a new sparse named vector. Only includes properties that define the vector space and cannot be changed after creation.
      - `modifier` union — Value modifier for sparse vectors (e.g., IDF)
        - 'none' | 'idf' — If used, include weight modification, which will be applied to sparse vectors at query time: None - no modification (default) Idf - inverse document frequency, based on statistics of the collection
        - unknown
      - `datatype` union — Datatype used to store weights in the index
        - 'float32' | 'float16' | 'uint8' | 'turbo4' — Storage types for vectors
        - unknown

## Response `200`

successful operation

- object
  - `usage` union
    - Usage — Usage of the hardware resources, spent to process the request
      - `hardware` 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
      - `inference` union
        - InferenceUsage
          - `models` object, required
        - unknown
    - 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' | 'wait_timeout', required — `Acknowledged` - Request is saved to WAL and will be process in a queue. `Completed` - Request is completed, changes are actual. `WaitTimeout` - Request is waiting for timeout.

## Other responses

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

## Changes

- **2026-08-05** `d08b1f613f29` — 2 info
  - added the new `turbo4` enum value to the request property `anyOf[#/components/schemas/DenseVectorNameConfig]/dense/datatype/anyOf[#/components/schemas/VectorStorageDatatype]/`
  - added the new `turbo4` enum value to the request property `anyOf[#/components/schemas/SparseVectorNameConfig]/sparse/datatype/anyOf[#/components/schemas/VectorStorageDatatype]/`
- **2026-05-20** `945e62a0043c` — 1 info
  - endpoint added

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