# 删除 Response

```{raw} html
<div class="mo-api-page-show-toc" aria-hidden="true"></div>
```

删除已保存的 Response。删除成功后，不能再通过查询接口访问该响应。

```text
DELETE https://token.moi.matrixorigin.cn/v1/responses/$RESPONSE_ID
```

## 调用前准备

1. 在支持保存和取回的模型服务上[创建 Response](../text-generation/responses.md#请求体)，并开启保存。选择仍可访问、未删除且未过期的响应。
2. 准备创建该响应时使用的[个人访问令牌](../../../../guides/genesis/api-keys.md#创建和管理个人访问令牌)。

## 请求示例

将示例中的 `$GENESIS_ACCESS_TOKEN` 和 `$RESPONSE_ID` 分别替换为个人访问令牌和所选响应的 ID。

```bash
curl -X DELETE \
  "https://token.moi.matrixorigin.cn/v1/responses/$RESPONSE_ID" \
  -H "Authorization: Bearer $GENESIS_ACCESS_TOKEN"
```

## 路径参数

::::{div} mo-api-parameter-table

| 参数 | 类型 | 是否必填 | 说明 |
| --- | --- | --- | --- |
| `response_id` | string | 是 | 已保存 Response 的标识，取自创建响应返回的 `id`。 |

::::

## 成功响应

成功时返回删除确认，之后不能再查询该响应。

:::::::{div} mo-api-tabs mo-api-response-tabs
::::::{tab-set}
:::::{tab-item} 响应示例

```json
{
  "id": "resp-example",
  "deleted": true
}
```

:::::
:::::{tab-item} 字段说明

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `id` | string | 被删除的 Response 标识。 |
| `deleted` | boolean | `true` 表示删除成功。 |

:::::
::::::
:::::::

## 错误响应

响应不存在、已删除、已过期或当前凭据无法访问时，返回 HTTP `404`。确认响应 ID 和创建时使用的凭据。

:::::::{div} mo-api-tabs mo-api-response-tabs
::::::{tab-set}
:::::{tab-item} 响应示例

```json
{
  "error": {
    "message": "response state not found",
    "type": "response_state_not_found",
    "code": "response_state_not_found"
  }
}
```

:::::
:::::{tab-item} 字段说明

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `error` | object | 错误信息。 |
| `error.message` | string | 不可访问或不存在的响应说明。 |
| `error.type` | string | 错误类别。 |
| `error.code` | string | 错误代码。 |

:::::
::::::
:::::::