candidate_tag_add - DropCV

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

参数

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

返回

{
  "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）。