Skip to main content
POST
/
files
/
upload
上传文件
curl --request POST \
  --url https://api.dropcv.work/api/external/v1/files/upload \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form file='@example-file' \
  --form 'original_filename=<string>'
{
  "file_id": "f_01HABCDEFGHIJKLMNOPQRSTUVW",
  "expires_at": "2023-11-07T05:31:56Z",
  "size_bytes": 123
}

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.

Authorizations

​
Authorization
string
header
required

DropCV API Key。在 设置 → API Keys 生成，格式 drop_cv_<32 位随机字符>。

Body

multipart/form-data
​
file
file
required

文件本体

​
mime_type
enum<string>
required

文件 MIME 类型

Available options:
application/pdf,
image/jpeg,
image/png
​
original_filename
string

原始文件名，用于显示（可选）

Response

上传成功

​
file_id
string

文件标识，传给 save_candidate 的 attachment_file_id

Example:

"f_01HABCDEFGHIJKLMNOPQRSTUVW"

​
expires_at
string<date-time>

未被写 skill 消费时的过期时间（24 小时）

​
size_bytes
integer

文件大小（字节）