删除会话
更新时间：2026-11-13
DELETE
https://api.dumate.cn/api/dma/v1/sessions/{session_id}
本接口用于删除指定的会话（Session）。
删除成功后返回被删除的会话标识；删除后再查询该会话返回 404。正在订阅该会话事件流的连接会依次收到 session.status_terminated、session.deleted 事件，随后连接关闭。
权限说明
使用 API Key 鉴权调用 API 流程，具体调用流程，请查看认证鉴权。
请求参数
Headers 参数
除公共头域外，无其它特殊头域
URL 参数
session_id
string
会话标识。
会话不存在时返回 404；会话不属于当前账号时返回 403。
必选
请求结构
DELETE /api/dma/v1/sessions/{session_id} HTTP/1.1
Host: api.dumate.cn
Authorization: Bearer <YOUR_API_KEY>示例代码
请求示例
curl --location --request DELETE "https://api.dumate.cn/api/dma/v1/sessions/ses_gffe5e3caaadc6ffe126cMcNQZsyuhP" \
--header 'Authorization: Bearer <YOUR_API_KEY>'返回响应
Headers 参数
除公共头域外，无其它特殊头域
返回参数
type
string
资源类型标识，固定为 session_deleted。
可选
id
string
被删除的会话标识。
可选
响应示例
{
"type": "session_deleted",
"id": "ses_gffe5e3caaadc6ffe126cMcNQZsyuhP"
}评价此篇文章