Workspace & folders
Functions for discovering the workspace tree and organizing it: listing folders and their contents, creating and renaming folders, opening objects in the editor, and moving objects between folders.
folder-listis the starting point for almost every Higento task — it returns the ids Higento needs to read, update, link, or move other objects.
folder-list
List folders in the organization with their contents. Returns each folder's id, name, parentId, and path (name trail), plus the agents, tools, knowledge bases, tables, and workflows it contains (each as id + display name). Optionally scope to a single folder subtree.
Input
| Field | Type | Required | Description |
|---|---|---|---|
folderId | string | null | No | Root folder id to scope results to (that folder + descendants). Omit or null for the full org tree. |
Output
| Field | Type | Description |
|---|---|---|
assistantFolderScopeId | string | null | The folder Higento is scoped to (if any). |
assistantFolderScopeName | string | Display name of the scope folder. |
rootFolderId | string | null | The requested scope root, or null for the whole org. |
folders | array | Folders in scope. Each: id, name, parentId, path, and arrays agents[], tools[], knowledgeBases[], tables[], workflows[] (each entry \{ id, name \}). |
folder-create
Create a new folder. Placement: omit parentFolderId to use the assistant's folder scope (or org root if unscoped); pass null for org root explicitly; pass a folder id to nest inside it.
Input
| Field | Type | Required | Description |
|---|---|---|---|
name | string | Yes | Display name for the new folder. |
parentFolderId | string | null | No | Omit = assistant scope/org root. null = org root. String = parent folder id. |
Output
| Field | Type | Description |
|---|---|---|
folderId | string | Id of the created folder (dir_…). |
parentId | string | null | Parent folder id, or null at org root. |
folder-rename
Rename a folder. Does not move it. Respects assistant folder scope.
Input
| Field | Type | Required | Description |
|---|---|---|---|
folderId | string | Yes | Id of the folder to rename. |
newName | string | Yes | New display name (min 1 char). |
Output
| Field | Type | Description |
|---|---|---|
folder | object | The updated folder: \{ id, name, parentId \}. |
workspace-navigate
Open an object in the workspace UI: the editor route for an agent, tool, workflow, table, or knowledge base, or the folder view for a folder. Does not navigate to schedules.
Input
| Field | Type | Required | Description |
|---|---|---|---|
kind | enum | Yes | One of folder, agent, tool, workflow, table, knowledgeBase. |
entityId | string | Yes | Id of the object, matching kind (folder→dir_…, agent→agt_…, tool→tool_…, workflow→wrk_…, table→t_…, knowledgeBase→kb_…). |
Output
| Field | Type | Description |
|---|---|---|
kind | string | The object kind that was opened. |
name | string | Display name of the opened object. |
entityId | string | Resolved object id (for agents this is the resolved agent id). |
pathAfterOrg | string | Route path after the org segment, used to navigate the UI. |
folderIdForQuery | string | null | Folder context for the route. |
path | string | Folder path trail (for kind: folder). |
workspace-move
Move one object into a destination folder. The kind must match the object referenced by entityId; Higento also infers kind from the id prefix to guard against mistakes. Moving a folder into one of its own descendants is rejected (cycle).
Input
| Field | Type | Required | Description |
|---|---|---|---|
kind | enum | Yes | Type of object being moved: agent, folder, tool, table, workflow. |
entityId | string | Yes | Id of the object being moved (matching kind). |
targetFolderId | string | null | Yes | Destination folder id (dir_…) or null for organization root. |
Output
| Field | Type | Description |
|---|---|---|
id | string | Id of the moved object. |