全部产品
Search
文档中心

Qoder CN 系列:取消当前 Turn

更新时间:Jul 14, 2026

取消 Forward Session 当前正在处理的 Turn。

请求头

Header

是否必填

说明

Authorization

Bearer <PAT>

Idempotency-Key

有副作用请求可选的幂等键。

路径参数

参数

类型

是否必填

说明

session_id

string

Session ID。

示例请求

curl -s -X POST 'https://api.qoder.com.cn/api/v1/forward/sessions/sess_xxx/cancel' \
  -H "Authorization: Bearer $QODER_PAT"

示例响应

HTTP 200 OK

{
  "id": "sess_xxx",
  "type": "session",
  "status": "canceling"
}

响应字段

字段

类型

说明

id

string

Session ID。

type

string

固定为 session

status

string

接受取消时返回 canceling

错误

HTTP

Type

Code

触发条件

404

not_found_error

session_not_found

Session 不存在。

409

conflict_error

session_archived

Session 已归档。

502

api_error

runtime_unavailable

运行时 Session 服务不可用。

401

authentication_error

authentication_required

PAT 无效或已过期。

备注

  • 202 Accepted 表示已发起取消。

  • 200 OK 表示当前没有正在处理的 Turn。

  • 取消完成状态可通过 Event Stream 或 Session 详情确认。

相关