Skip to main content
GET
/
knowledge
/
list
curl -X GET https://api.thinnest.ai/knowledge/list \
  -H "Authorization: Bearer $THINNESTAI_API_KEY"
{
  "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"

Query Parameters

agent_id
string
required
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

sources[].id
integer
Source ID
sources[].name
string
Source name or URL
sources[].type
string
Source type (see Source Types)
sources[].status
string
processing, ready, failed
sources[].char_count
integer \
null
sources[].chunk_count
integer \
null
sources[].created_at
string
ISO 8601 creation timestamp

Source Types

TypeDescription
textRaw text content
urlWeb page (crawled)
fileUploaded document (PDF, DOCX, TXT)
csvCSV data
jsonJSON data
markdownMarkdown document
youtubeYouTube video transcript
excelExcel spreadsheet
github_repoGitHub repository
azure_blobAzure Blob Storage
sharepointSharePoint document
ocrOCR-processed document

Errors

CodeDescription
401Missing or invalid authentication
404Agent not found

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

limit
integer
default:100
Required range: 1 <= x <= 500
offset
integer
default:0
Required range: x >= 0
status
string

Response

Successful Response