Get Knowledge Base
Retrieve a specific knowledge base by its ID.
GET
Headers
x-workspace-idstringrequiredWorkspace identifier for the API.
Path Parameters
idstringrequiredThe unique identifier of the knowledge base.
Response
_idstringUnique identifier for the knowledge base.
namestringName of the knowledge base.
descriptionstringDescription of the knowledge base, if one was given.
workspaceIdstringWorkspace ID associated with the knowledge base.
isSMBbooleantrue for a Basic knowledge base (the agent reads its text in full rather than searching an index), false for a standard one.
filesarrayUploaded files plus, if set, the text entry. At most 5 entries.
textContentstringThe knowledge base's text, if any was set with Add Text.
usedInPathwaysarrayLegacy field, usually empty. Use Get Knowledge Base Usage to see which flows use the knowledge base.
createdAtstringTimestamp when the knowledge base was created.
updatedAtstringTimestamp when the knowledge base was last updated.
Errors
| Status | Body | When |
|---|---|---|
404 | {"message": "Knowledge base not found"} | No knowledge base with this ID in the workspace |
500 | {"message": "Failed to retrieve knowledge base"} | Unexpected server error |
{
"_id": "a4a4a4a4a4a4a4a4a4a4a4a4",
"name": "Product Documentation",
"description": "All product-related documentation and FAQs",
"workspaceId": "d1d1d1d1d1d1d1d1d1d1d1d1",
"isSMB": false,
"files": [
{
"_id": "a7a7a7a7a7a7a7a7a7a7a7a7",
"filename": "product-guide.pdf",
"key": "workspaces/d1d1d1d1d1d1d1d1d1d1d1d1/knowledge-bases/a4a4a4a4a4a4a4a4a4a4a4a4/1761735600000-product-guide.pdf",
"url": "https://example-bucket.s3.amazonaws.com/workspaces/d1d1d1d1d1d1d1d1d1d1d1d1/knowledge-bases/a4a4a4a4a4a4a4a4a4a4a4a4/1761735600000-product-guide.pdf",
"mimetype": "application/pdf",
"size": 1048576,
"isText": false,
"uploadedAt": "2026-10-29T10:00:00.000Z"
}
],
"usedInPathways": [],
"createdAt": "2026-10-29T09:00:00.000Z",
"updatedAt": "2026-10-29T10:00:00.000Z"
}Last updated on