List Files in Source
curl --request GET \
--url https://api.example.com/knowledge/{knowledge_id}/sources/{source_id}/files \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.example.com/knowledge/{knowledge_id}/sources/{source_id}/files"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.example.com/knowledge/{knowledge_id}/sources/{source_id}/files', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.example.com/knowledge/{knowledge_id}/sources/{source_id}/files",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.example.com/knowledge/{knowledge_id}/sources/{source_id}/files"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.example.com/knowledge/{knowledge_id}/sources/{source_id}/files")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/knowledge/{knowledge_id}/sources/{source_id}/files")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"source_id": "company-s3",
"source_name": "Company Documents",
"prefix": "reports/",
"folders": [
{
"prefix": "reports/2024/",
"name": "2024",
"is_empty": false
}
],
"files": [
{
"key": "reports/annual-summary.pdf",
"name": "annual-summary.pdf",
"size": 102400,
"last_modified": "2024-01-15T10:30:00Z",
"content_type": "application/pdf"
}
],
"meta": {
"page": 1,
"limit": 100,
"total_pages": 1,
"total_count": 1
}
}{
"detail": "Bad request"
}{
"detail": "Unauthenticated access"
}{
"detail": "Not found"
}{
"detail": [
{
"loc": [
"body",
"endpoint"
],
"msg": "Value error, Endpoint must be a path, not a full URL",
"type": "value_error"
}
]
}{
"detail": "Internal server error"
}Knowledge
List Files in Source
List available files and folders in a specific content source. Supports pagination and folder navigation.
GET
/
knowledge
/
{knowledge_id}
/
sources
/
{source_id}
/
files
List Files in Source
curl --request GET \
--url https://api.example.com/knowledge/{knowledge_id}/sources/{source_id}/files \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.example.com/knowledge/{knowledge_id}/sources/{source_id}/files"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.example.com/knowledge/{knowledge_id}/sources/{source_id}/files', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.example.com/knowledge/{knowledge_id}/sources/{source_id}/files",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.example.com/knowledge/{knowledge_id}/sources/{source_id}/files"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.example.com/knowledge/{knowledge_id}/sources/{source_id}/files")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/knowledge/{knowledge_id}/sources/{source_id}/files")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"source_id": "company-s3",
"source_name": "Company Documents",
"prefix": "reports/",
"folders": [
{
"prefix": "reports/2024/",
"name": "2024",
"is_empty": false
}
],
"files": [
{
"key": "reports/annual-summary.pdf",
"name": "annual-summary.pdf",
"size": 102400,
"last_modified": "2024-01-15T10:30:00Z",
"content_type": "application/pdf"
}
],
"meta": {
"page": 1,
"limit": 100,
"total_pages": 1,
"total_count": 1
}
}{
"detail": "Bad request"
}{
"detail": "Unauthenticated access"
}{
"detail": "Not found"
}{
"detail": [
{
"loc": [
"body",
"endpoint"
],
"msg": "Value error, Endpoint must be a path, not a full URL",
"type": "value_error"
}
]
}{
"detail": "Internal server error"
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
ID of the knowledge base
ID of the content source
Query Parameters
Path prefix to filter files
Number of files per page
Required range:
1 <= x <= 1000Page number (1-indexed)
Required range:
x >= 1Folder delimiter (enables folder grouping)
The ID of the database to use
Response
Files listed successfully
Response schema for listing files in a content source.
ID of the content source
Name of the content source
Pagination metadata
Show child attributes
Show child attributes
Prefix filter that was applied
Subfolders at this level
Show child attributes
Show child attributes
List of files at this level
Show child attributes
Show child attributes
Was this page helpful?