Why is filterByTql getting deprecated?

[dkindlund]

Hi @tea-artist, can you help me understand why the filterByTql param is getting deprecated?
https://help.teable.io/en/api-reference/record/list-records#parameter-filter-by-tql

If I want to be able to search in a table that contains a linked field where I want to search by the linked field's primary field name... that doesn't seem possible to do with the current filter syntax -- or maybe I'm missing something here?

In general, the filter documentation is really, really sparse and I don't understand how it can be used in complex situations. Any clarification here would be appreciated. Thanks!

[tea-artist]

The "filterByTQL" param has some semantic inaccuracies in certain specific cases, especially as it does not have a perfect one-to-one correspondence with the "formula". Ultimately, we decided to use the filter object as the parameter. To address the complex configuration issues, we also provided a visual interface to assist developers in assembling the parameters.

Here, you can perfectly reproduce any query that can be implemented in the Grid view.
https://app.teable.ai/developer/tool/query-builder