---
title: "Remove aliases in bulk"
method: POST
path: "/cdn/aliases/remove"
tags: ["Aliases"]
---

# Remove aliases in bulk

`POST /cdn/aliases/remove`

## Request

- Base URL: `https://api.gcore.com`
- URL: `https://api.gcore.com/cdn/aliases/remove`
- Auth: HTTP apikey

Delete up to 1000 aliases in a single request, selected either by ID or by hostname.

Aliases that are not found are reported in `not_found` and do not fail the request.

## Request body

- AliasesRemovePayload: Pass exactly one of `ids` or `cnames`.
  - `ids` integer[]: IDs of the aliases to delete.
  - `cnames` string[]: Hostnames of the aliases to delete.

## Response `200`

Successful.

- AliasesRemoveResponse
  - `removed` AliasRemoved[]: Aliases deleted by this request.
    - `id` integer
    - `cname` string
  - `not_found` AliasIdentifier[]: Requested IDs or hostnames that did not match an alias.
    - union
      - integer
      - string

## Other responses

- `400`: Validation failed.
- `403`: Aliases are not enabled for your account.

## Changes

- **2026-09-15** `adafd38a196b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/g-core/apis/gcore-openapi/changes/cdn/aliases/remove/post.md)

---

[API](https://skmtc.dev/g-core/apis/gcore-openapi.md) - [All operations](https://skmtc.dev/g-core/apis/gcore-openapi/llms.txt) - [OpenAPI document](https://skmtc.dev/g-core/apis/gcore-openapi/revisions/a2b772345f3a?raw)