candidate_note_add - DropCV

candidate_note_add 往候选人的笔记时间线追加一条笔记。笔记是 append-only 的条目流 —— 每条带一个自由分类 title 和正文 content，新笔记追加在后，不覆盖已有内容。

参数

字段	类型	必填	说明
`candidate_id`	uuid	是	候选人 ID
`title`	string	是	笔记分类 / 标题，自由定（如「面聊记录」「我的判断」「薪资沟通」），1–120 字
`content`	string	是	笔记正文
`image_object_keys`	string[]	否	附件图片的对象存储 object key 列表

返回

{
  "candidate_id": "uuid",
  "note_id": "n_xxxxxxxxxxxx",
  "note_count": 3
}

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

示例

curl -X POST https://api.dropcv.work/api/external/v1/skills/candidate_note_add/invoke \
  -H "Authorization: Bearer $DROPCV_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "params": {
      "candidate_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "title": "我的判断",
      "content": "技术功底扎实，沟通清晰，值得推进。"
    }
  }'

权限

需要 write 权限。

说明

append-only：每次调用追加一条，不会覆盖或合并已有笔记。
候选人笔记只能用这个 skill 写 —— candidate_update 不接受笔记字段。
title 是自由分类，由调用方决定，不是固定枚举 —— 想分几类分几类。