# DNS

Use DNS endpoints to manage DNS records for your domains. You can list all existing DNS records for a domain and create, update, or delete records as needed.

## List Records

 - [GET /core/v1/domains/{domainName}/records](https://docs.name.com/api-spec-cdn/namecom.api/dns/listrecords.md): Lists all DNS records for a specified domain.

## Create Record

 - [POST /core/v1/domains/{domainName}/records](https://docs.name.com/api-spec-cdn/namecom.api/dns/createrecord.md): Adds a new DNS record to the specified domain zone. Provide the record type (e.g. A, MX, CNAME), host, value, and TTL.  This is used for configuring domain-based services such as email, website hosting, or third-party verifications.

## Delete Record

 - [DELETE /core/v1/domains/{domainName}/records/{id}](https://docs.name.com/api-spec-cdn/namecom.api/dns/deleterecord.md): Removes a DNS record by ID. Often used during cleanup operations or when replacing outdated DNS settings with updated records.

## Get Record

 - [GET /core/v1/domains/{domainName}/records/{id}](https://docs.name.com/api-spec-cdn/namecom.api/dns/getrecord.md): Retrieves details of a specific DNS record.

## Update Record

 - [PUT /core/v1/domains/{domainName}/records/{id}](https://docs.name.com/api-spec-cdn/namecom.api/dns/updaterecord.md): Replaces an existing DNS record with new data. This is a full overwrite — all required fields (host, type, answer, ttl) must be included in the request body. If you omit a field, the existing value will not be preserved and the request may fail. Use GetRecord beforehand to retrieve the current values if you intend to modify just one field. The record ID must belong to a domain you manage.