DELETE /api/v1/forward/identities/{identity_id}
当前实现为软删除:服务端内部标记 deleted,不级联删除历史 Session、事件或审计记录。
请求头
| Header | 是否必填 | 说明 |
|---|---|---|
| Authorization | 是 | Bearer <PAT> |
路径参数
| 参数 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| identity_id | string | 是 | Forward Identity ID。 |
示例请求
示例响应
HTTP 200 OK响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
| id | string | 被删除的 Identity ID。 |
| deleted | boolean | 是否已标记删除。 |
错误
| HTTP | Type | Code | 触发条件 |
|---|---|---|---|
| 404 | not_found_error | - | Identity 不存在或当前调用方不可见。 |
| 409 | conflict_error | - | 当前状态不允许删除。 |
| 401 | authentication_error | authentication_required | PAT 无效或已过期。 |
注意事项
- 删除后的 Identity 不允许继续创建 Session。
- 删除操作不会物理清理历史记录。