Skip to main content
GET
Get a knowledge source

Authorizations

Authorization
string
header
required

An API key from Settings → API keys, sent as Authorization: Bearer kb_live_…. A workspace key starts kb_; a personal key starts kbp_ and acts as its owner.

Headers

Kallabot-Version
enum<string>

The API version to answer as, a date (YYYY-MM-DD). Leave it out for the current version (2026-11-07). An unknown version is refused with 400 unsupported_api_version.

Available options:
2026-11-07
Example:

"2026-11-07"

Path Parameters

source_id
string
required

Response

Successful Response

id
string
required
name
string
required
kind
enum<string>
required
Available options:
text,
url,
file,
sheet,
faq,
catalog
status
enum<string>
required
Available options:
processing,
ready,
failed
char_count
integer
required
source_url
string | null
required
file_name
string | null
required
error
string | null
required
progress
integer
required

Indexing progress, 0 to 100.

warnings
KnowledgeWarning · object[]
required
chunks
integer
required

Passages it was cut into; 0 before the first index.

indexed_at
string | null
required
refresh_interval_hours
integer | null
required
last_refreshed_at
string | null
required
created_at
string | null
required
updated_at
string | null
required
used_by
KnowledgeAgent · object[]
required

Agents you can see that use this source.

used_elsewhere
integer
required

Agents in branches you can't see that use it.

text
string
required

The text the agent reads.