Skip to main content
POST
cURL

Autorisierungen

Authorization
string
header
erforderlich

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

Pfadparameter

tableId
string
erforderlich
fieldId
string
erforderlich

Body

application/json
name
string
erforderlich
viewId
string

Antwort

201 - application/json

Returns duplicated field data

id
string
erforderlich

The id of the field.

name
string
erforderlich

The name of the field. can not be duplicated in the table.

Beispiel:

"Tags"

type
enum<string>
erforderlich

The field types supported by teable.

Verfügbare Optionen:
singleLineText,
longText,
user,
attachment,
checkbox,
multipleSelect,
singleSelect,
date,
number,
rating,
formula,
rollup,
conditionalRollup,
link,
createdTime,
lastModifiedTime,
createdBy,
lastModifiedBy,
autoNumber,
button
Beispiel:

"singleSelect"

options
object
erforderlich

The configuration options of the field. The structure of the field's options depend on the field's type.

cellValueType
enum<string>
erforderlich

The cell value type of the field.

Verfügbare Optionen:
string,
number,
boolean,
dateTime
dbFieldType
enum<string>
erforderlich

The field type of database that cellValue really store.

Verfügbare Optionen:
TEXT,
INTEGER,
DATETIME,
REAL,
BLOB,
JSON,
BOOLEAN
dbFieldName
string
erforderlich

Field(column) name in backend database. Limitation: 1-63 characters, can only contain letters, numbers and underscore, case sensitive, cannot be duplicated with existing db field name in the table.

Minimum string length: 1
Pattern: ^\w{0,63}$
description
string

The description of the field.

Beispiel:

"this is a summary"

meta
object

The metadata of the field. The structure of the field's meta depend on the field's type. Currently formula and link fields have meta.

aiConfig

The AI configuration of the field.

isLookup
boolean

Whether this field is lookup field. witch means cellValue and [fieldType] is looked up from the linked table.

isConditionalLookup
boolean

Whether this lookup field applies a conditional filter when resolving linked records.

lookupOptions
object

field lookup options.

notNull
boolean

Whether this field is not null.

unique
boolean

Whether this field is not unique.

isPrimary
boolean

Whether this field is primary field.

isComputed
boolean

Whether this field is computed field, you can not modify cellValue in computed field.

isPending
boolean

Whether this field's calculation is pending.

hasError
boolean

Whether This field has a configuration error. Check the fields referenced by this field's formula or configuration.

isMultipleCellValue
boolean

Whether this field has multiple cell value.

recordRead
boolean

Field record read permission. When set to false, reading records is denied. When true or not set, reading records is allowed.

recordCreate
boolean

Field record create permission. When set to false, creating records is denied. When true or not set, creating records is allowed.

Zuletzt geändert am 4. September 2026