跳转到主要内容
GET
/
table
/
{tableId}
/
aggregation
/
group-points
Get group points
curl --request GET \
  --url http://127.0.0.1:3000/api/table/{tableId}/aggregation/group-points \
  --header 'Authorization: Bearer <token>'
[
  {
    "id": "<string>",
    "type": 0,
    "depth": 1,
    "isCollapsed": true,
    "value": "<unknown>"
  }
]

授权

Authorization
string
header
必填

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

路径参数

tableId
string
必填

查询参数

viewId
string

Set the view you want to fetch, default is first view. result will filter and sort by view options.

示例:

"viwXXXXXXX"

filter
string

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.

search

Search for records that match the specified field and value

Required array length: 1 element
groupBy
string

An array of group objects that specifies how the records should be grouped.

collapsedGroupIds
string

An array of group ids that specifies which groups are collapsed

ignoreViewQuery

When a viewId is specified, configure this to true will ignore the view's filter, sort, etc

响应

200 - application/json
object[] | null

Group points for the view

id
string
必填
type
enum<number>
必填
可用选项:
0
depth
number
必填
必填范围: 0 <= x <= 2
isCollapsed
boolean
必填
value
unknown
Last modified on December 10, 2025