Sasha MCP reference

Workspaces: make a knowledge project visible in the sidebar

This is the workspaces section of the usage guide. Call getDocs with { "section": "workspaces" } to read it on an instance.

In the Sasha web interface, the documents of a knowledge project show in the sidebar only inside a workspace (a chat project) with the same name: open the workspace and its Knowledge section lists them. A project that you fill only with writeDoc has no workspace, so people cannot see its documents in the sidebar.

  • listProjects gives each project hasWorkspace (true or false) when this connection may create workspaces.
  • createProject creates the workspace, or confirms that it exists. Send name (the project id, for example transcriptions), and optionally displayName (the name the sidebar shows) and folderId (a sidebar folder for a new workspace). The name is cleaned as the web interface cleans it: lower case, and other characters become -. It returns { created, project: { id, name, displayName, folderId } }. An existing workspace returns created: false and is not changed, so it is safe to call every time, before or after writeDoc. Documents already in the knowledge project stay as they are. Open browsers show the new workspace at once.

createProject needs knowledge:read and knowledge:write, and is offered only to an admin or staff user, because members do not use Sasha chat. Sasha's own chat does not have it. Refusals: forbidden:name_reserved (a member home, a private chats project or a deleted project's name), invalid_input:name_invalid (no letter or digit), not_found:folder_not_found and repository_busy:knowledge_lock_busy (try again in a few seconds).

Built with BernardCookie settings