Skip to main content
Knowledge folders are the structural layer of Fini’s live knowledge graph. Use these routes to inspect the current folder structure, manage folders, move articles between folders, and decide which agents can use that knowledge.
Folders organize articles. They are not a second source of truth. The article content inside those folders is still what the agent retrieves from.

​
Reference pages

Get knowledge folders

GET /v2/hc-folders/public — return the current tree snapshot, optionally scoped to one agent.

Create knowledge folder

POST /v2/hc-folders/public — create a folder in the tree.

Update knowledge folder

PUT /v2/hc-folders/:id/public — update a folder’s title, description, or active state.

Move knowledge folder

PUT /v2/hc-folders/:id/move/public — move a folder under a different parent.

Move article

PUT /v2/hc-articles/:id/move/public — move an article into a different folder.

Delete knowledge folder

DELETE /v2/hc-folders/:id/public — delete a folder from the tree.

Assign knowledge to agents

POST /v2/hc-bot-folder-junctions/public — assign or unassign folders to agents in bulk.

​
Endpoint map

MethodPathScopePurpose
GET/v2/hc-folders/publicreadReturn the current knowledge-tree snapshot, optionally scoped to one agent.
POST/v2/hc-folders/publicwriteCreate a folder in the knowledge tree.
PUT/v2/hc-folders/:id/publicwriteUpdate a folder’s title, description, or active state.
PUT/v2/hc-folders/:id/move/publicwriteMove a folder under a different parent.
PUT/v2/hc-articles/:id/move/publicwriteMove an article into a different folder.
DELETE/v2/hc-folders/:id/publicwriteDelete a folder from the tree.
POST/v2/hc-bot-folder-junctions/publicwriteAssign or unassign folders to agents in bulk.

​
Knowledge folders snapshot object

​
id
string
Snapshot ID.
​
createdAt
string
ISO 8601 creation timestamp.
​
updatedAt
string
ISO 8601 last-update timestamp.
​
snapshotObjV2
array
Nested folder-and-article tree for the workspace. When botId is supplied, this array is filtered to the folders assigned to that agent.
The workspace-API-key response for GET /v2/hc-folders/public does not include companyId or publicSnapshotV2, even though those fields exist on the stored snapshot internally.

​
Folder object

​
id
string
Folder ID.
​
companyId
string
Workspace ID that owns the folder.
​
parentFolderId
string | null
Parent folder ID. null or empty for a top-level folder.
​
title
string
Folder title.
​
description
string
Folder description.
​
misc
object
Internal metadata object for the folder.
​
active
boolean
Whether the folder is active.
​
createdAt
string
ISO 8601 creation timestamp.
​
updatedAt
string
ISO 8601 last-update timestamp.
Use the child pages in this section for the detailed request and response reference for each route.