Skip to main content
Identities

停用 Identity

停用一个 Forward Identity。

POST /api/v1/forward/identities/{identity_id}/disable

请求头

Header是否必填说明
Authorization是Bearer <PAT 或 SAT>

路径参数

参数类型是否必填说明
identity_idstring是Forward Identity ID。

示例响应

HTTP 200 OK 
{
  "id": "idn_019eabc123",
  "enabled": false
}

响应字段

字段类型说明
idstringIdentity ID。
enabledboolean停用后的状态，固定为 false。

错误

HTTPTypeCode触发条件
401authentication_error-PAT 或 SAT 无效、已过期或缺失。
404not_found_error-Identity 不存在或当前调用方不可见。
409conflict_errorADMIN_IDENTITY_READ_ONLY目标为管理员 Identity。

备注

停用后，Identity 不再接受新的 API 或 IM 执行请求，也不再启动新的 Schedule 执行。停用前已经接受的执行会自然完成，事件流、重连和结果投递继续；停用不会自动取消任务或截断输出。已经通过执行检查的请求仍可能在停用响应返回后开始运行。 已有待处理动作的工具确认或工具结果可继续提交，但必须匹配该会话的真实待处理动作，不能混入新的用户消息。手动取消、删除、归档及凭据吊销仍遵循各自规则。 Identity 开关不会改写 Schedule 或 Channel 自身的开关。重新启用后的排期和会话行为见启用 Identity。