---
title: "API·删除外部域名"
description: "POST /api/v1/dns/manage/remove_domain 接口，从宝塔域名管理系统中移除外部域名，同时清除该域名的所有解析记录，不可逆调用前需确认。"
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.bt.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# API·删除外部域名

## 删除外部域名

## 接口描述

从堡塔域名管理系统中删除外部域名。删除后将无法继续使用堡塔的 DNS 解析服务。

**接口地址：** `POST /api/v1/dns/manage/remove_domain`

:::warning 警告
删除域名是不可逆操作，删除后该域名的所有解析记录也将被清除。请确认操作后再执行。
:::

## 输入参数

### 请求示例

```json
{
  "domain_id": 1
}
```

### 请求参数

| 参数名称 | 必选 | 类型 | 描述 |
|---------|------|------|------|
| domain_id | 是 | Integer | 域名 ID |

## 输出参数

### 响应示例

**成功响应：**

```json
{
  "code": 0,
  "data": {
    "domain_id": 1,
    "full_domain": "example.com"
  },
  "msg": "域名移除成功",
  "status": true
}
```

**错误响应：**

```json
{
  "code": 404,
  "msg": "域名不存在",
  "status": false
}
```

### 响应参数

| 参数名称 | 类型 | 描述 |
|---------|------|------|
| code | Integer | 状态码，0 表示成功 |
| status | Boolean | 请求是否成功 |
| msg | String | 返回消息 |
| data | Object | 返回数据 |

**data 字段说明：**

| 参数名称 | 类型 | 描述 |
|---------|------|------|
| domain_id | Integer | 域名 ID |
| full_domain | String | 域名名称 |

Source: https://docs.bt.cn/domain/api/dns-records/remove-domain/index.mdx