火山方舟
火山方舟
API参考
请输入
- 文档首页
火山方舟Managed Agents APISessions删除会话
复制全文
下载 pdf删除会话
文档反馈
问问助手DELETE https://ark.cn-beijing.volces.com/api/v3/sessions/{session_id}
删除会话前，请根据会话状态处理：
- status 为 idle（空闲）或 terminated（已终止）：可以直接删除。
- status 为 running（运行中）：先发送 user.interrupt，等待 status 恢复为 idle 后再删除。
- status 为其他值：等待当前操作完成，并在 status 恢复为 idle 后再删除。
如需中断当前任务但保留会话，请发送 user.interrupt，不要删除会话。
鉴权
- API Key 鉴权，请在 API Key 管理 页面，获取长效 API Key。
请求参数
Path 参数
session_id string 必选 | 会话 ID
要删除的会话 ID，格式为 sesn- 开头的字符串。
响应参数
id string | 会话 ID
被删除的会话 ID。
type string | 对象类型
对象类型，固定为 session_deleted。
删除会话
发起调试等同于请求真实调用，可能产生云产品费用，请谨慎操作！
Request
cURL
curl -sS --fail-with-body -X DELETE "https://ark.cn-beijing.volces.com/api/v3/sessions/<SESSION_ID>" \
-H "Authorization: Bearer $ARK_API_KEY"Response
{
"id": "<SESSION_ID>",
"type": "session_deleted"
}最近更新时间：2026.10.30 21:22:48
这个页面对您有帮助吗？
有用
有用
无用
无用