Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.dropcv.work/llms.txt

Use this file to discover all available pages before exploring further.

candidate_tag_add 往候选人的自定义标签（custom_tags）里追加一个或多个标签。append-only + 自动去重 —— 只加不删，不会动已有标签。

​
参数

字段类型必填说明
candidate_iduuid是候选人 ID
tagsstring[]是要追加的标签，一个或多个；已存在的会自动跳过

​
返回

{
  "candidate_id": "uuid",
  "custom_tags": ["大厂背景", "可远程"],
  "added": ["可远程"]
}
custom_tags 是追加后的完整标签列表，added 是本次实际新增的（去重后）。 候选人不存在（或不属于当前 API Key 所属用户）时返回 CANDIDATE_NOT_FOUND (404)。

​
示例

curl -X POST https://api.dropcv.work/api/external/v1/skills/candidate_tag_add/invoke \
  -H "Authorization: Bearer $DROPCV_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "params": {
      "candidate_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "tags": ["大厂背景", "可远程"]
    }
  }'

​
权限

需要 write 权限。

​
说明

  • append-only + 去重：只加不删；传入已存在的标签会被忽略。
  • 删标签 / 整体替换标签：用 webapp 的候选人编辑界面（或 PATCH /candidates）。