​
路径

POST /api/table/{tableId}/record/{recordId}/{fieldId}/uploadAttachment

​
请求

​
路径参数

附件字段可以上传多个附件，该 API 每次允许上传一个附件到单元格最末尾 如需删除或调整附件顺序请使用更新记录 API fieldId 必须为附件类型字段 通过 API 上传的附件在云端版本中最大为 100m, 在私有化版本中无限制

​
请求体

类型：formData 参数：
  • file（ 可选）
    • 描述：要更新的记录数据
    • 类型：Buffer 或 ReadStream
  • fileUrl（可选）
    • 描述：要进行上传的 URL
    • 类型：字符串
    • 示例：https://app.teable.io/favicon.ico
    • 说明：file 和 fileUrl 同时只能指定一个，若都制定则优先 file

​
响应

​
成功响应

  • 状态码: 201 Created
  • 响应体: 返回更新后的记录数据。
示例响应体 
{
    "id": "rec123456789ABCDE",
    "fields": {
      "fld123456789ABCDE": [
        {
          "id": "act75TiSyhcS7hfrizW",
          "name": "example.jpg",
          "path": "table/example",
          "size": 392903,
          "token": "tokenxxxxx",
          "width": 976,
          "height": 1000,
          "mimetype": "image/jpeg",
          "presignedUrl": "https://sss.teable.io/pvt-assets/table/previewURL"
        }
      ],
    }
}

​
错误响应

  • 状态码: 400 Bad Request: 请求体格式错误或缺少必需字段。
  • 状态码: 404 Not Found: 指定的表 tableId 或记录 recordId 不存在。

​
示例代码

# 通过文件上传

curl -X POST 'https://app.teable.cn/api/table/__tableId__/record/__recordId__/__fieldId__/uploadAttachment' \
  -H 'Authorization: Bearer __token__' \
  -H 'Content-Type: multipart/form-data' \
  -F 'file=@/path/to/your/file.jpg'

# 通过 URL 上传
curl -X POST 'https://app.teable.cn/api/table/__tableId__/record/__recordId__/__fieldId__/uploadAttachment' \
  -H 'Authorization: Bearer __token__' \
  -H 'Content-Type: multipart/form-data' \
  -F 'fileUrl=https://example.com/image.jpg'