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

# 按 ID 删除咏唱引擎云会话

> 按标识符删除咏唱引擎云会话，并一并删除其轮次、条目、记忆片段与子智能体。该操作不可逆。

删除一个会话及其全部关联状态：轮次、条目、记忆片段与子智能体。该操作不可逆。

## 接口

```http theme={null}
DELETE /v1/agents/sessions/{session_id}
```

## 认证

`Authorization: Bearer <api_key>` 或 `Authorization: ApiKey <api_key>`。

## 路径参数

<ParamField path="session_id" type="string" required>
  会话标识符。
</ParamField>

## 响应

<ResponseField name="id" type="string">
  已删除的会话标识符。
</ResponseField>

<ResponseField name="object" type="string">
  恒为 `agent.session.deleted`。
</ResponseField>

<ResponseField name="deleted" type="boolean">
  成功时恒为 `true`。
</ResponseField>

## 示例

```bash theme={null}
curl -X DELETE https://agent.example.com/v1/agents/sessions/sess_0198c... \
  -H "Authorization: Bearer $ARIA_AGENT_KEY"
```

```json theme={null}
{
  "id": "sess_0198c...",
  "object": "agent.session.deleted",
  "deleted": true
}
```

<Warning>
  已删除的会话无法恢复。如果你需要保留对话记录，请使用 [更新会话](/api-reference/agent/sessions/update) 进行归档。
</Warning>