candidate_delete - DropCV

candidate_delete 把一个候选人从人才库永久删除，连带其向量 embedding 等关联记录一并级联删除。

破坏性操作，删除后不可恢复。调用前请确认 candidate_id 无误。

参数

字段	类型	必填	说明
`candidate_id`	uuid	是	要删除的候选人 ID

返回

{
  "candidate_id": "uuid",
  "deleted": true
}

候选人不存在（或不属于当前 API Key 所属用户）时返回 CANDIDATE_NOT_FOUND (404)。

示例

curl -X POST https://api.dropcv.work/api/external/v1/skills/candidate_delete/invoke \
  -H "Authorization: Bearer $DROPCV_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "params": {
      "candidate_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
    }
  }'

权限

需要 write 权限。

审计

每次删除都会写入审计，可在设置 → 用量按 invocation_id 查询调用方和时间。