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

# Deletes a specific secondary domain.

`DELETE /domains/secondary/{domainId}`

## Request

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

This endpoint deletes a specific secondary 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 secondary 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`: Secondary 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)