更新记录

​

路径

PATCH /table/{tableId}/record/{recordId}

​

请求

​

路径参数

• tableId (string): 表的唯一标识符（如何获取）。
• recordId (string): 要更新的记录的唯一标识符 (如何获取）。

​

请求体

• record（必填）
  • 描述：要更新的记录数据
  • 类型：对象
  • 示例：

    {
      "fields": {
        "Name": "John Doe",
        "Age": 31,
        "Email": "john.doe@example.com"
      }
    }
    

  • 说明：fields 对象包含要更新的字段名和对应的新值。每一种字段值结构都不一样，详情请查看记录字段值类型

要清空一个字段的值请显式的传递 null,如果字段名没有传递则不会进行任何更新

• fieldKeyType（可选）
  • 描述：指定字段键的类型
  • 类型：字符串
  • 可选值：
    • “name”：使用字段名作为键
    • “id”：使用字段 ID 作为键
  • 示例："name" 或 "id"
  • 说明：如果不指定，默认使用字段名作为键。
  • 用法：
    • 当设置为 “name” 时：

      {
        fields: {
          "Name": "John Doe",
          "Age": 30
        }
      }
      

    • 当设置为 “id” 时：

      {
        fields: {
          "fldABCDEFGHIJKLMN": "John Doe",
          "fldOPQRSTUVWXYZ12": 30
        }
      }
      

• typecast（可选）
  • 描述：是否自动转换字段值类型，默认会严格校验，需要保证输入的值符合当前字段的数据类型，如果开启则会尝试自动进行转换。
  • 类型：布尔值
  • 可选值：true 或 false
  • 示例：true
  • 说明：如果设置为 true，系统会尝试将输入值转换为正确的字段值类型。
  • 用法示例：
    • 关联字段：可以直接使用主键文本进行关联

      {
        "User table": "张三"
      }
      

    • 日期字段：可以使用非标准格式的日期字符串

      {
        "Date": "2023-05-15"
      }
      

    • 用户字段：可以直接使用用户名

      {
        "Assigned To": "John Doe"
      }
      

如果需要上传新文件到附件字段，请参阅上传附件章节

​

响应

​

成功响应

• 状态码: 200 OK
• 响应体: 返回更新后的记录数据。

示例响应体

{
    "id": "rec123456789ABCDE",
    "fields": {
        "Name": "John Doe",
        "Age": 31,
        "Email": "john.doe@example.com"
    }
}

​

错误响应

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

​

示例代码

curl -X PATCH 'https://app.teable.cn/table/__tableId__/record/__recordId__' \
  -H 'Authorization: Bearer __token__' \
  -H 'Content-Type: application/json' \
  -d '{
    "record": {
      "fields": {
        "Name": "John Doe",
        "Age": 31
      }
    }
  }'