---
title: "Update aliases of the collections"
method: POST
path: "/collections/aliases"
tags: ["Aliases"]
---

# Update aliases of the collections

`POST /collections/aliases`

## Query parameters

- `timeout` integer

## Request body

- ChangeAliasesOperation — Operation for performing changes of collection aliases. Alias changes are atomic, meaning that no collection modifications can happen between alias operations.
  - `actions` AliasOperations[], required
    - union — Group of all the possible operations related to collection aliases
      - CreateAliasOperation
        - `create_alias` CreateAlias, required — Create alternative name for a collection. Collection will be available under both names for search, retrieve,
          - `collection_name` string, required
          - `alias_name` string, required
      - DeleteAliasOperation — Delete alias if exists
        - `delete_alias` DeleteAlias, required — Delete alias if exists
          - `alias_name` string, required
      - RenameAliasOperation — Change alias to a new one
        - `rename_alias` RenameAlias, required — Change alias to a new one
          - `old_alias_name` string, required
          - `new_alias_name` string, required

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

## Other responses

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

## Changes

> 18 revisions in range; 1 could not be searched.

- **2026-05-20** `945e62a0043c` — 1 warning
  - for the `query` request parameter `timeout`, the min was set to `1.00`
- **2025-11-17** `d09f337ca2f3` — 2 info
  - added `#/components/schemas/Usage` to the `usage` response property `anyOf` list for the response status `200`
  - removed `#/components/schemas/HardwareUsage` from the `usage` response property `anyOf` list for the response status `200`
- **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` — 3 info
  - api tag `Aliases` added
  - api tag `collections` removed
  - added the optional property `usage` to the response with the `200` status

[Change history](https://skmtc.dev/qdrant/apis/qdrant-api/changes/collections/aliases/post.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)