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
Knowledge folders snapshot object
string
Snapshot ID.
string
ISO 8601 creation timestamp.
string
ISO 8601 last-update timestamp.
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
string
Folder ID.
string
Workspace ID that owns the folder.
string | null
Parent folder ID.
null or empty for a top-level folder.string
Folder title.
string
Folder description.
object
Internal metadata object for the folder.
boolean
Whether the folder is active.
string
ISO 8601 creation timestamp.
string
ISO 8601 last-update timestamp.
Use the child pages in this section for the detailed request and response reference for each route.