TOOL API

aitable__query_records

Queries records in a DingTalk AI Table table, either by record IDs or by filter conditions. Pass recordIds (up to 100) to fetch specific records directly, or use filters, sort and cursor to page through the whole table; use fieldIds (up to 100) to limit returned fields and reduce response size.

enterpriseOAuth1 credits

Call information

Tool slug
dingtalk.aitable__query_records
Provider
DingTalk
Average response
0 ms
Calls in 7 days
0

Input parameters

baseIdrequired

Base ID（通过 list_bases / search_bases 获取）

cursor

可选。分页游标，首次查询不传。当返回结果包含 cursor 字段时，将其传入下一次请求以获取后续数据； cursor 为空表示已取完全部记录。

fieldIds

可选。指定要返回的字段 ID 列表。省略则返回所有字段。 建议在字段较多时按需传入，可显著减少响应体积；单次最多 100 个。

filters

结构化过滤条件，不传则返回全部记录（受 limit 限制）

keyword

全文关键词。将对整表内容做文本匹配搜索，并返回符合条件的记录。

limit

可选。单次返回的最大记录数，默认 100，最大 100。

recordIds

可选。指定要获取的记录 ID 列表，单次最多 100 个。传入时直接按 ID 返回，忽略 filters 和 sort。 适用于已知 recordId（如关联字段中的 linkedRecordIds）时的精准取数。

sort

可选。排序条件列表，按数组顺序依次生效。 每个元素：{"fieldId": "<fieldId>", "direction": "asc" | "desc"} 示例（先按优先级升序，再按截止日期降序）： [ {"fieldId": "fldPriorityId", "direction": "asc"}, {"fieldId": "fldDueDateId", "directi...

tableIdrequired

Table ID（通过 get_base 获取）