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_update 修改候选人的允许字段。只传你要改的字段，未传的不变。

​
参数

字段类型必填说明
candidate_iduuid是候选人 ID
fieldsobject是要修改的字段字典（至少一个）

​
可改字段（白名单）

按语义分组：

​
基础

full_name · gender · birth_year · age · current_city · current_status · hometown

​
联系

phone · email · wechat · linkedin_url

​
教育

highest_education · school_name · major · graduation_year

​
工作 + 薪资

current_company · current_title · job_level · years_of_experience · current_company_tenure · management_experience · team_size · salary_min · salary_max · salary_unit · salary_period

​
标签（数组字段）

school_level_tags · industries · functions · skills · preferred_locations · private_judgement_tags · custom_tags

​
备注（文本字段）

interview_notes · personality_notes · concerns · motivation · recommendation_notes

​
不可改字段

id / user_id / ai_*_tags（AI 建议标签自动维护） / dedup_fingerprint / field_meta / created_at / updated_at / profile_status 如果 fields 里包含上述任何一个，请求会返回 INVALID_PARAMS (422)。

​
返回

{
  "candidate_id": "uuid",
  "updated_fields": ["phone", "current_title", "interview_notes"]
}

​
示例

curl -X POST https://api.dropcv.work/api/external/v1/skills/candidate_update/invoke \
  -H "Authorization: Bearer $DROPCV_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "params": {
      "candidate_id": "...",
      "fields": {
        "current_title": "技术总监",
        "current_company": "新创业公司",
        "interview_notes": "5/12 一面通过，技术功底扎实",
        "skills": ["Python", "Go", "Rust"]
      }
    }
  }'

​
权限

需要 write 权限。

​
审计

修改后的每个字段都会在 candidate.field_meta 留下来源（source: external_api、api_key_id、修改时间），便于将来追溯。