curl -X GET https://api.thinnest.ai/knowledge/list \
-H "Authorization: Bearer $THINNESTAI_API_KEY"
import requests
url = "https://api.thinnest.ai/knowledge/list"
headers = {
"Authorization": "Bearer " + "YOUR_THINNESTAI_API_KEY",
}
response = requests.get(url, headers=headers)
print(response.json())
const response = await fetch("https://api.thinnest.ai/knowledge/list", {
method: "GET",
headers: {
"Authorization": "Bearer " + "YOUR_THINNESTAI_API_KEY",
},
});
const data = await response.json();
console.log(data);
package main
import (
"fmt"
"io"
"net/http"
)
func main() {
req, _ := http.NewRequest("GET", "https://api.thinnest.ai/knowledge/list", nil)
req.Header.Set("Authorization", "Bearer YOUR_THINNESTAI_API_KEY")
resp, err := http.DefaultClient.Do(req)
if err != nil { panic(err) }
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}
{
"sources": [
{
"id": 1,
"name": "Product FAQ",
"type": "text",
"status": "ready",
"char_count": 4500,
"chunk_count": 12,
"created_at": "2026-03-01T10:00:00Z"
},
{
"id": 2,
"name": "https://docs.example.com",
"type": "url",
"status": "processing",
"char_count": null,
"chunk_count": null,
"created_at": "2026-03-07T14:00:00Z"
},
{
"id": 3,
"name": "manual.pdf",
"type": "file",
"status": "ready",
"char_count": 28000,
"chunk_count": 85,
"created_at": "2026-03-05T09:00:00Z"
}
]
}
Knowledge
List Sources
List all knowledge sources for an agent.
GET
/
knowledge
/
list
curl -X GET https://api.thinnest.ai/knowledge/list \
-H "Authorization: Bearer $THINNESTAI_API_KEY"
import requests
url = "https://api.thinnest.ai/knowledge/list"
headers = {
"Authorization": "Bearer " + "YOUR_THINNESTAI_API_KEY",
}
response = requests.get(url, headers=headers)
print(response.json())
const response = await fetch("https://api.thinnest.ai/knowledge/list", {
method: "GET",
headers: {
"Authorization": "Bearer " + "YOUR_THINNESTAI_API_KEY",
},
});
const data = await response.json();
console.log(data);
package main
import (
"fmt"
"io"
"net/http"
)
func main() {
req, _ := http.NewRequest("GET", "https://api.thinnest.ai/knowledge/list", nil)
req.Header.Set("Authorization", "Bearer YOUR_THINNESTAI_API_KEY")
resp, err := http.DefaultClient.Do(req)
if err != nil { panic(err) }
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}
{
"sources": [
{
"id": 1,
"name": "Product FAQ",
"type": "text",
"status": "ready",
"char_count": 4500,
"chunk_count": 12,
"created_at": "2026-03-01T10:00:00Z"
},
{
"id": 2,
"name": "https://docs.example.com",
"type": "url",
"status": "processing",
"char_count": null,
"chunk_count": null,
"created_at": "2026-03-07T14:00:00Z"
},
{
"id": 3,
"name": "manual.pdf",
"type": "file",
"status": "ready",
"char_count": 28000,
"chunk_count": 85,
"created_at": "2026-03-05T09:00:00Z"
}
]
}
curl -X GET https://api.thinnest.ai/knowledge/list \
-H "Authorization: Bearer $THINNESTAI_API_KEY"
import requests
url = "https://api.thinnest.ai/knowledge/list"
headers = {
"Authorization": "Bearer " + "YOUR_THINNESTAI_API_KEY",
}
response = requests.get(url, headers=headers)
print(response.json())
const response = await fetch("https://api.thinnest.ai/knowledge/list", {
method: "GET",
headers: {
"Authorization": "Bearer " + "YOUR_THINNESTAI_API_KEY",
},
});
const data = await response.json();
console.log(data);
package main
import (
"fmt"
"io"
"net/http"
)
func main() {
req, _ := http.NewRequest("GET", "https://api.thinnest.ai/knowledge/list", nil)
req.Header.Set("Authorization", "Bearer YOUR_THINNESTAI_API_KEY")
resp, err := http.DefaultClient.Do(req)
if err != nil { panic(err) }
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}
Query Parameters
The agent’s public ID (ag_*)
Response 200
{
"sources": [
{
"id": 1,
"name": "Product FAQ",
"type": "text",
"status": "ready",
"char_count": 4500,
"chunk_count": 12,
"created_at": "2026-03-01T10:00:00Z"
},
{
"id": 2,
"name": "https://docs.example.com",
"type": "url",
"status": "processing",
"char_count": null,
"chunk_count": null,
"created_at": "2026-03-07T14:00:00Z"
},
{
"id": 3,
"name": "manual.pdf",
"type": "file",
"status": "ready",
"char_count": 28000,
"chunk_count": 85,
"created_at": "2026-03-05T09:00:00Z"
}
]
}
Response Fields
Source ID
Source name or URL
Source type (see Source Types)
processing, ready, failed
null
null
ISO 8601 creation timestamp
Source Types
| Type | Description |
|---|---|
text | Raw text content |
url | Web page (crawled) |
file | Uploaded document (PDF, DOCX, TXT) |
csv | CSV data |
json | JSON data |
markdown | Markdown document |
youtube | YouTube video transcript |
excel | Excel spreadsheet |
github_repo | GitHub repository |
azure_blob | Azure Blob Storage |
sharepoint | SharePoint document |
ocr | OCR-processed document |
Errors
| Code | Description |
|---|---|
401 | Missing or invalid authentication |
404 | Agent not found |
⌘I

