POST
/
table
/
{tableId}
/
view
curl --request POST \
  --url https://app.teable.io/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","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"}},"pluginId":"string"}'
{
  "id": "<string>",
  "name": "<string>",
  "type": "grid",
  "description": "<string>",
  "order": 123,
  "options": {
    "rowHeight": "short",
    "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,
gantt,
plugin
name
string
description
string
order
number
options
object
sort
object | null
filter
object

A filter object used to filter results. It allows complex query conditions based on fields, operators, and values.

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

A mapping of view IDs to their corresponding column metadata.

pluginId
string

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,
gantt,
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
sort
object | null
filter
object

A filter object used to filter results. It allows complex query conditions based on fields, operators, and values.

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