Skip to content

Get source by ID

GET
/knowledge-bases/{knowledgeBaseId}/sources/{sourceId}
knowledgeBaseId
required

ID of the knowledge base

string

ID of the knowledge base

sourceId
required

ID of the source to retrieve

string

ID of the source to retrieve

Source found

object
knowledgeBaseSourceId
required

Unique identifier for the source (nanoid format)

string
knowledgeBaseId
required

ID of the parent knowledge base

string
fileId
required

ID of the file source (mutually exclusive with tableId)

string
nullable
datasetTableId
required

ID of the dataset table source (mutually exclusive with fileId)

string
nullable
columnSpec
required

For table sources: specifies which columns to process

object
columns
required

Column names to extract content from

Array<string>
status
required

Processing status of the source

string
Allowed values: pending processing processed failed stale
processedExtractionId
required

ID of the extraction used when this source was processed

string
nullable
processedDatasetVersion
required

Version of dataset when last processed

number
nullable
addedAt
required

ISO 8601 timestamp when the source was added

string format: date-time
processedAt
required

ISO 8601 timestamp when the source was last processed

string format: date-time
nullable
syncErrorMessage
required

Error message from the most recent failed sync attempt

string
nullable
metadata
required

User-defined metadata for filtering retrieval

object
key
additional properties
Any of:
string
metadataStale
required

True if metadata has changed and chunks need re-indexing

boolean

Unauthorized - Authentication required or invalid token

object
error
required
string
code
string
details
nullable
retryable
boolean

Forbidden - Insufficient permissions

object
error
required
string
code
string
details
nullable
retryable
boolean

Not Found - Resource does not exist

object
error
required
string
code
string
details
nullable
retryable
boolean