跳转到主要内容
POST
/
table
/
{tableId}
/
record
Create records
curl --request POST \
  --url http://127.0.0.1:3000/api/table/{tableId}/record \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "records": [
    {
      "fields": {
        "single line text": "text value"
      }
    }
  ],
  "fieldKeyType": "name",
  "typecast": true,
  "order": {
    "viewId": "<string>",
    "anchorId": "<string>",
    "position": "before"
  }
}
'
{
  "records": [
    {
      "id": "recXXXXXXX",
      "fields": {
        "single line text": "text value"
      }
    }
  ]
}

授权

​
Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

路径参数

​
tableId
string
必填

请求体

application/json

Multiple Create records

​
records
object[]
必填

Array of record objects

示例:
[
  {
    "fields": { "single line text": "text value" }
  }
]
​
fieldKeyType
enum<string>
默认值:name

Define the key type of record.fields[key], You can click "systemInfo" in the field edit box to get fieldId or enter the table design screen with all the field details

可用选项:
id,
name,
dbFieldName
​
typecast
boolean

Automatic data conversion from cellValues if the typecast parameter is passed in. Automatic conversion is disabled by default to ensure data integrity, but it may be helpful for integrating with 3rd party data sources.

​
order
object

Where this record to insert to (Optional)

响应

201 - application/json

Returns data about the records.

​
records
object[]
必填

Array of record objects

示例:
[
  {
    "id": "recXXXXXXX",
    "fields": { "single line text": "text value" }
  }
]
Last modified on December 10, 2025