POST
/
table
/
{tableId}
/
record
curl --request POST \
  --url https://app.teable.cn/api/table/%7BtableId%7D/record \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN' \
  --header 'content-type: application/json' \
  --data '{"fieldKeyType":"id","typecast":true,"order":{"viewId":"string","anchorId":"string","position":"before"},"records":[{"fields":{"single line text":"text value"}}]}'
{
  "records": [
    {
      "id": "recXXXXXXX",
      "fields": {
        "single line text": "text value"
      }
    }
  ],
  "extra": {
    "groupPoints": [
      {
        "id": "<string>",
        "type": 0,
        "depth": 1,
        "value": "<any>",
        "isCollapsed": true
      }
    ]
  }
}

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
tableId
string
required

Body

application/json

Multiple Create records

​
records
object[]
required

Array of record objects

Example:
[
  {
    "fields": { "single line text": "text value" }
  }
]
​
fieldKeyType
enum<string>
default: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

Available options:
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)

Response

201 - application/json
Returns data about the records.
​
records
object[]
required

Array of record objects

Example:
[
  {
    "id": "recXXXXXXX",
    "fields": { "single line text": "text value" }
  }
]
​
extra
object