Skip to main content
GET
/
orgs
/
{org_id}
/
k2
/
{kb_id}
/
files
cURL
curl --request GET \
  --url https://api.timbal.ai/orgs/{org_id}/k2/{kb_id}/files \
  --header 'Authorization: Bearer <token>'
{
  "files": [
    {
      "content_length": 123,
      "content_type": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "id": 123,
      "kb_id": 123,
      "metadata": "<unknown>",
      "name": "<string>",
      "parse_state": "<string>",
      "uid": "<string>",
      "updated_at": "2023-11-07T05:31:56Z",
      "url": "<string>",
      "directory": "<string>"
    }
  ],
  "next_page_token": "<string>"
}
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 one folder. Use "/" for KB root (entries with no parent path). Omit to list every file in the knowledge base. Otherwise a normalized path such as docs/reports.

Response

200 - application/json

Files listed successfully

​
files
object[]
required
​
next_page_token
string | null