Workspace Mechanics

Workspaces are the foundation of how Xio stores and organizes your content. Each workspace holds its own:

• Files

• Embeddings

• Chat history

• Configuration state

This allows you to keep separate projects or topics isolated from each other. For example, you might have one workspace for legal documents and another for research articles.

When you upload a file, it belongs only to the currently active workspace. All questions you ask will be answered using only that workspace’s indexed content.

Workspaces are persistent and can be renamed, reset, or removed entirely from the settings panel.

To reset a workspace:

bashCopyEditcurl -X POST http://localhost:3001/api/workspaces/reset \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{ "workspace": "default" }'

Each workspace functions like a contained knowledge base, making it easy to segment your data and stay organized.