List Knowledge Documents
curl --request GET \
--url https://app.thinnest.ai/api/v1/agents/{id}/knowledge \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://app.thinnest.ai/api/v1/agents/{id}/knowledge', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://app.thinnest.ai/api/v1/agents/{id}/knowledge"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"items": [
{
"id": "doc_f7413c2a-9d0e-4b6f-8a21-3e5c7d9b1f04",
"title": "Sky Towers price list",
"type": "text",
"source": "pasted",
"status": "ready",
"error": null,
"createdAt": "2026-10-02T11:20:05.441Z"
},
{
"id": "doc_2b9e7d14-6c3a-4f81-b0d5-9a7e1c4f3b62",
"title": "https://skylinehomes.example/faq",
"type": "url",
"source": "https://skylinehomes.example/faq",
"status": "failed",
"error": "No readable text found — the page may require JavaScript or a login.",
"createdAt": "2026-09-28T07:02:51.019Z"
}
],
"nextCursor": null
}{
"error": "`cursor` is not one this API handed out."
}{
"error": "Send a valid API key as `Authorization: Bearer <key>`."
}{
"error": "That agent was not found."
}{
"error": "Over 240 requests a minute. Slow down and retry."
}Knowledge
List Knowledge Documents
The agent’s documents, newest first, with whether each is ready to be cited. Files uploaded in the console are listed here too.
GET
/
agents
/
{id}
/
knowledge
List Knowledge Documents
curl --request GET \
--url https://app.thinnest.ai/api/v1/agents/{id}/knowledge \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://app.thinnest.ai/api/v1/agents/{id}/knowledge', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://app.thinnest.ai/api/v1/agents/{id}/knowledge"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"items": [
{
"id": "doc_f7413c2a-9d0e-4b6f-8a21-3e5c7d9b1f04",
"title": "Sky Towers price list",
"type": "text",
"source": "pasted",
"status": "ready",
"error": null,
"createdAt": "2026-10-02T11:20:05.441Z"
},
{
"id": "doc_2b9e7d14-6c3a-4f81-b0d5-9a7e1c4f3b62",
"title": "https://skylinehomes.example/faq",
"type": "url",
"source": "https://skylinehomes.example/faq",
"status": "failed",
"error": "No readable text found — the page may require JavaScript or a login.",
"createdAt": "2026-09-28T07:02:51.019Z"
}
],
"nextCursor": null
}{
"error": "`cursor` is not one this API handed out."
}{
"error": "Send a valid API key as `Authorization: Bearer <key>`."
}{
"error": "That agent was not found."
}{
"error": "Over 240 requests a minute. Slow down and retry."
}Authorizations
Your API key (ta_live_…) from Settings → API keys, sent as Authorization: Bearer <key>. Keep it on a server: it can message every customer you have. A key is full, build or read-only; a request its level does not allow is refused with 403.
Headers
Developers only: the customer workspace this request acts in — its org_… id from POST /customers. Leave it out to act in your own workspace.
Example:
"org_3fKq9TzQ1mN8vB2xR7cLpA"
Path Parameters
The agent's id (ag_…).
Query Parameters
How many items to return, 1 to 100.
Required range:
1 <= x <= 100The nextCursor from the previous page. Leave it out for the first page.