Skip to main content
GET
cURL
Both regular files and folders are returned. Folder entries have 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

Authorization
string
header
required

Timbal API key. Obtain your API key from the Timbal platform settings. See Authentication for more information.

Path Parameters

org_id
string
required
kb_id
string
required

Query Parameters

page_token
string | null

Page token for pagination

directory
string | null

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.

q
string | null

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.

Response

200 - application/json

Files listed successfully

files
object[]
required
next_page_token
string | null