DELETE /sessions/{sid}

删除会话及其所有消息。

DELETE /cells/{cellID}/sessions/{sid}

路径参数

参数	类型	说明
`cellID`	string	Cell ID
`sid`	string	会话 ID

请求体

无。

curl 示例

curl -s -X DELETE "http://localhost:9091/cells/dept-legal/sessions/ses-a1b2c3d4" \
  -H "Authorization: Bearer $TOKEN" | jq .

响应

200 OK

{
  "ok": true
}

注意事项

删除操作会同时移除会话的所有消息、Checkpoint 和 Branch。
如果会话中有正在执行的 Run，会先中断该 Run 再删除。
对不存在的会话执行删除也返回 200（幂等）。

⚠️ 不可逆操作：删除后无法恢复会话内容。请确认操作意图后再调用。

错误码

HTTP	错误	说明
401	—	未认证或 Token 无效
403	—	无权删除该会话（Actor 不匹配）
404	—	Cell 不存在

相关端点

GET /sessions — 列出会话
GET /sessions/{sid}/messages — 获取会话消息
POST /sessions/{sid}/interrupt — 中断 Run