跳转到主要内容
DELETE /api/v1/forward/identities/{identity_id} 当前实现为软删除:服务端内部标记 deleted,不级联删除历史 Session、事件或审计记录。

请求头

Header是否必填说明
AuthorizationBearer <PAT>

路径参数

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

示例请求

curl -s -X DELETE 'https://api.qoder.com/api/v1/forward/identities/idn_019eabc123' \
  -H "Authorization: Bearer $QODER_PAT"

示例响应

HTTP 200 OK
{
  "id": "idn_019eabc123",
  "deleted": true
}

响应字段

字段类型说明
idstring被删除的 Identity ID。
deletedboolean是否已标记删除。

错误

HTTPTypeCode触发条件
404not_found_error-Identity 不存在或当前调用方不可见。
409conflict_error-当前状态不允许删除。
401authentication_errorauthentication_requiredPAT 无效或已过期。

注意事项

  • 删除后的 Identity 不允许继续创建 Session。
  • 删除操作不会物理清理历史记录。

相关

列出 Identities

创建 Identity