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

> 给候选人追加自定义标签。

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

## 参数

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

## 返回

```json theme={null}
{
  "candidate_id": "uuid",
  "custom_tags": ["大厂背景", "可远程"],
  "added": ["可远程"]
}
```

`custom_tags` 是追加后的完整标签列表，`added` 是本次实际新增的（去重后）。

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

## 示例

```bash theme={null}
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`）。