Removing a domain

Written by

Yandex Cloud

Updated at June 29, 2026

View in Markdown

Management console

CLI

API

In the management console, select the folder containing the API gateway.
Navigate to API Gateway.
Click the API gateway name.
Navigate to the Domains tab.
Click in the domain row and select Detach.
Confirm your action.
Delete the resource record created when adding the domain to the API gateway:
- If your domain is delegated to Cloud DNS:
  1. Navigate to Cloud DNS.
  2. Select the zone hosting the domain.
  3. Click in the record row with the icon and select Delete.
  4. Confirm the deletion.
- If a third-party DNS provider manages your domain, delete the record on the domain management page of your provider.

If you do not have the Yandex Cloud CLI yet, install and initialize it.

The folder used by default is the one specified when creating the CLI profile. To change the default folder, use the yc config set folder-id <folder_ID> command. You can also specify a different folder for any command using --folder-name or --folder-id. If you access a resource by its name, the search will be limited to the default folder. If you access a resource by its ID, the search will be global, i.e., through all folders based on access permissions.

View the description of the CLI command for removing a domain:
```
yc serverless api-gateway remove-domain --help
```

Run this command:

yc serverless api-gateway remove-domain <API_gateway_ID> --domain-id <domain_ID>

Delete the resource record created when adding the domain to the API gateway:
- If your domain is delegated to Cloud DNS:
  1. Get a list of all records in the DNS zone by specifying the relevant zone ID:
```
yc dns zone list-records <DNS_zone_ID>
```
    The record in question is of the ANAME type and has a value in d5dm1lba80md********.i9******.apigw.yandexcloud.net format.
  2. Delete the record:
```
yc dns zone delete-records <DNS_zone_ID> \
  --record "<domain_name> <TTL> <record_type> <value>"
```
- If a third-party DNS provider manages your domain, delete the record on the domain management page of your provider.

To remove a domain from an API gateway, use the removeDomain REST API method for the ApiGateway resource or the ApiGatewayService/RemoveDomain gRPC API call.

Delete the resource record created when adding the domain to the API gateway:

If your domain is delegated to Cloud DNS, use the updateRecordSets REST API method for the DnsZone resource or the DnsZoneService/UpdateRecordSets gRPC API call.
If a third-party DNS provider manages your domain, delete the record on the domain management page of your provider.

Removing a domain

Was the article helpful?