# 删除会话条目

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

删除本地会话中的一条条目；删除后无法再查询该条目。

```text
DELETE https://token.moi.matrixorigin.cn/v1/conversations/{conversation_id}/items/{item_id}
```

## 调用前准备

1. 准备具有 Genesis 权限的[个人访问令牌](../../../../guides/genesis/api-keys.md#创建和管理个人访问令牌)。
2. 使用[创建会话](create-conversation.md)时的凭据，选择尚未删除、尚未关联上游模型的本地会话。
3. 选择通过[添加会话条目](create-item.md)或[查询会话条目列表](list-items.md)取得的条目。

## 请求示例

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

将 `$ITEM_ID` 替换为所选条目的 ID。

```bash
curl -X DELETE "https://token.moi.matrixorigin.cn/v1/conversations/$CONVERSATION_ID/items/$ITEM_ID" \
  -H "Authorization: Bearer $GENESIS_ACCESS_TOKEN"
```

## 路径参数

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

| 参数 | 类型 | 是否必填 | 说明 |
| --- | --- | --- | --- |
| `conversation_id` | string | 是 | 创建会话响应中的 `id`。 |
| `item_id` | string | 是 | 目标条目的 `id`，必须属于指定会话。 |

::::

## 成功响应

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

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

```json
{
  "id": "$ITEM_ID",
  "object": "conversation.item.deleted",
  "deleted": true
}
```

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

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `id` | string | 已删除资源的标识。 |
| `object` | string | 删除结果类型。 |
| `deleted` | boolean | 成功删除时为 `true`。 |

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

## 错误响应

资源不存在、已删除或当前凭据不可访问时，请求返回 `404`。

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

```json
{
  "error": {
    "message": "conversation item not found",
    "type": "conversation_item_not_found",
    "code": "conversation_item_not_found"
  }
}
```

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

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `error` | object | 错误信息。 |
| `error.message` | string | 错误原因。 |
| `error.type` | string | 错误类别。 |
| `error.code` | string | 错误代码。 |

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