---
title: "Deletes a specific primary domain."
method: DELETE
path: "/domains/primary/{domainId}"
tags: ["domains - primary"]
---

# Deletes a specific primary domain.

`DELETE /domains/primary/{domainId}`

## Request

- Base URL: `https://manager.digicertdns.com/v1`
- URL: `https://manager.digicertdns.com/v1/domains/primary/{domainId}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/digicert/apis/digicert-dns/docs/domains/primary/:domainId/delete.ts> (a function with typed inputs; its response is checked against the schema)

This endpoint deletes a specific primary domain, allowing users to remove it from the system.</br></br>Key features include:</br></br>- **Clear success messaging:** Returns `202` and `204` success codes with confirmation messages indicating the successful completion of the requested action.</br>- **Comprehensive error handling:** Returns `403`, `404`, and `409` error codes with clear descriptions when requests fail.</br>- **Efficient lifecycle management:** Facilitates the removal of a primary domain, helping maintain a clean and organized system.</br>- **Targeted data deletion:** Utilizes the `domainId` parameter to delete the specified domain, ensuring precise removal with enhanced control and accuracy.

## Path parameters

- `domainId` integer, required

## Response `202`

Domain deletion request accepted.

## Other responses

- `204`: Primary domain deleted successfully.
- `403`: Request is forbidden.
- `404`: Resource not found.
- `409`: Conflict detected.

---

[API](https://skmtc.dev/digicert/apis/digicert-dns.md) - [All operations](https://skmtc.dev/digicert/apis/digicert-dns/llms.txt) - [OpenAPI document](https://skmtc.dev/digicert/apis/digicert-dns/revisions/c74fc728cff8?raw)