附件接口
附件上传接口必须通过 X-Employee-Virtual-Id 指定当前操作人，上传后可把返回 URL 回填到任务创建请求的 attachmentUrls。
POST
/api/openplatform/attachments
上传附件，表单字段名固定为 file，一次只能提交一个文件，单个文件最大 100MB。
必填请求头：必须提供
X-Employee-Virtual-Id 和 UUID 格式的 X-Client-Request-Id。未传操作人时返回 403。{
"statusCode": 100,
"msg": "上传成功",
"data": {
"url": "https://cdn.example.com/task/20260617/demo.pdf",
"fileName": "demo.pdf",
"fileSize": 204800,
"id": "b34b6f3f-f84e-45ce-8c44-bb85d55a9ef5"
}
}
MCP 工具
attachment_upload
个人 MCP 服务可直接上传本地文件。调用者需要拥有 attachments.write 权限；系统固定以个人 API Key 所有者作为操作人，上传成功后返回的 attachmentUrl 可直接放入其他 MCP 工具的 attachmentUrls。
文件限制：
fileName 只能是单一文件名；contentBase64 必须是原始二进制内容的标准 Base64 字符串，不得传 data: 前缀。MCP 单文件解码后最大 10MB；REST 上传接口仍保持单文件最大 100MB。{
"fileName": "meeting-notes.pdf",
"contentBase64": "JVBERi0xLjQK..."
}
{
"attachmentUrl": "https://cdn.example.com/task/20260617/meeting-notes.pdf",
"fileName": "meeting-notes.pdf",
"sizeBytes": 204800,
"attachmentId": "b34b6f3f-f84e-45ce-8c44-bb85d55a9ef5"
}