跳转到主要内容
POST
/
table
/
{tableId}
/
view
shell
curl --request POST \
  --url https://app.teable.cn/api/table/%7BtableId%7D/view \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN' \
  --header 'content-type: application/json' \
  --data '{"name":"string","type":"grid","description":"string","order":0,"options":{"rowHeight":"short","fieldNameDisplayLines":1,"frozenColumnCount":0},"sort":{"sortObjs":[{"fieldId":"string","order":"asc"}],"manualSort":true},"filter":{},"group":[{"fieldId":"string","order":"asc"}],"isLocked":true,"shareId":"string","enableShare":true,"shareMeta":{"allowCopy":true,"includeHiddenField":true,"password":"string","includeRecords":true,"submit":{"allow":true,"requireLogin":true}},"columnMeta":{"property1":{"order":0,"width":0,"hidden":true,"statisticFunc":"count"},"property2":{"order":0,"width":0,"hidden":true,"statisticFunc":"count"}}}'
{
  "id": "<string>",
  "name": "<string>",
  "type": "grid",
  "description": "<string>",
  "order": 123,
  "options": {
    "rowHeight": "short",
    "fieldNameDisplayLines": 2,
    "frozenColumnCount": 1
  },
  "sort": {
    "sortObjs": [
      {
        "fieldId": "<string>",
        "order": "asc"
      }
    ],
    "manualSort": true
  },
  "filter": {},
  "group": [
    {
      "fieldId": "<string>",
      "order": "asc"
    }
  ],
  "isLocked": true,
  "shareId": "<string>",
  "enableShare": true,
  "shareMeta": {
    "allowCopy": true,
    "includeHiddenField": true,
    "password": "<string>",
    "includeRecords": true,
    "submit": {
      "allow": true,
      "requireLogin": true
    }
  },
  "createdBy": "<string>",
  "lastModifiedBy": "<string>",
  "createdTime": "<string>",
  "lastModifiedTime": "<string>",
  "columnMeta": {},
  "pluginId": "<string>"
}

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
​
type
enum<string>
required
Available options:
grid,
calendar,
kanban,
form,
gallery,
plugin
​
name
string
​
description
string
​
order
number
​
options
object
  • Option 1
  • Option 2
  • Option 3
  • Option 4
  • Option 5
  • Option 6
​
sort
object | null
​
filter
object

A filter object for complex query conditions based on fields, operators, and values. Use our visual query builder at https://app.teable.ai/developer/tool/query-builder to build filters.

​
group
object[] | null
​
isLocked
boolean
​
shareId
string
​
enableShare
boolean
​
shareMeta
object
​
columnMeta
object

A mapping of view IDs to their corresponding column metadata.

Response

201 - application/json

Returns data about a view.

​
id
string
required
​
name
string
required
​
type
enum<string>
required
Available options:
grid,
calendar,
kanban,
form,
gallery,
plugin
​
createdBy
string
required
​
createdTime
string
required
​
columnMeta
object
required

A mapping of view IDs to their corresponding column metadata.

​
description
string
​
order
number
​
options
object
  • Option 1
  • Option 2
  • Option 3
  • Option 4
  • Option 5
  • Option 6
​
sort
object | null
​
filter
object

A filter object for complex query conditions based on fields, operators, and values. Use our visual query builder at https://app.teable.ai/developer/tool/query-builder to build filters.

​
group
object[] | null
​
isLocked
boolean
​
shareId
string
​
enableShare
boolean
​
shareMeta
object
​
lastModifiedBy
string
​
lastModifiedTime
string
​
pluginId
string
⌘I