Aliases

Remove aliases in bulk

Changed on

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.

post/cdn/aliases/remove

Request

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

Request body

idsinteger[]

IDs of the aliases to delete.

cnamesstring[]

Hostnames of the aliases to delete.

Example request

{
  "ids": [
    1,
    2,
    3
  ],
  "cnames": [
    "shop.example.com",
    "www.example.com"
  ]
}

Response

Successful.

Example response

{
  "removed": [
    {
      "id": 1,
      "cname": "shop.example.com"
    }
  ],
  "not_found": [
    "www.example.com"
  ]
}

Changes