> ## 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

> 给候选人的笔记时间线追加一条笔记。

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

## 参数

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

## 返回

```json theme={null}
{
  "candidate_id": "uuid",
  "note_id": "n_xxxxxxxxxxxx",
  "note_count": 3
}
```

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

## 示例

```bash theme={null}
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` 是自由分类，由调用方决定，不是固定枚举 —— 想分几类分几类。