Knowledge Store
Get Knowledge Item
Read one knowledge item by its path
GET
https://www.stardeck.ai/api/v1/knowledge/items/{path}Retrieve a single knowledge item by its path. The key's role needs the item's read permission, after folder-level overrides; otherwise the response is 403.
pathpath
string
required
The item path, e.g. docs/api/overview.md. Nested paths use / separators.
Response
{
"success": true,
"data": {
"item": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"organizationId": "org_2abc123",
"path": "docs/api/overview.md",
"content": "# API Overview\n\nWelcome to the API.",
"itemType": "text",
"fileKey": null,
"fileName": null,
"contentType": null,
"fileSize": null,
"requiredReadPermission": "inherit",
"requiredWritePermission": "inherit",
"createdAt": "2026-01-15T10:30:00.000Z",
"updatedAt": "2026-01-15T10:30:00.000Z"
}
}
}successboolean
required
Always true for successful responses.
dataobject
required
ShowHide data
itemKnowledgeItem
required
The knowledge item.
ShowHide KnowledgeItem
idstring
required
UUID of the item.
pathstring
required
File-like path.
contentstring
required
Item content.
itemTypestring
required
Either text or file.
createdAtstring
required
ISO 8601 timestamp.
updatedAtstring
required
ISO 8601 timestamp.
Next steps
Create or Update Knowledge Item
Write an item at a path