List Files
List files and folders in a knowledge base directory.
content_type set to application/vnd.timbal.k2-directory and content_length of 0. Use the optional directory query parameter to scope results to a specific folder (e.g. ?directory=docs).Authorizations
Timbal API key. Obtain your API key from the Timbal platform settings. See Authentication for more information.
Query Parameters
Page token for pagination
Scope listing to the immediate contents of one folder, like a file browser:
the files directly in it plus a folder entry per immediate subfolder (one
level only). Use "/" for the KB root. Omit to get a flat dump of every
file in the knowledge base at all depths. Otherwise a normalized path such
as docs/reports.
Case-insensitive substring filter on entry name. When set, results are a
flat recursive search: directory scopes the search to that folder's
subtree (omit or use "/" to search the whole knowledge base) and no
folder entries are synthesized.