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

​
参数

字段类型必填说明
candidate_iduuid是候选人 ID
titlestring是笔记分类 / 标题，自由定（如「面聊记录」「我的判断」「薪资沟通」），1–120 字
contentstring是笔记正文
image_object_keysstring[]否附件图片的对象存储 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 是自由分类，由调用方决定，不是固定枚举 —— 想分几类分几类。