> ## Documentation Index
> Fetch the complete documentation index at: https://docs.switchagents.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> These docs moved from docs.flintai.dev to docs.switchagents.ai. Use docs.switchagents.ai for every link and request.
> To search these docs from an AI tool, connect the MCP server at https://docs.switchagents.ai/mcp. The page index is at https://docs.switchagents.ai/llms.txt.
> The source code for these products is public on GitHub. Switch Rooms: https://github.com/sandbox-quantum/switch. Switch Trust CLI: https://github.com/sandbox-quantum/switch-trust-cli. Switch Trust CodeScan action: https://github.com/sandbox-quantum/switch-trust-codescan-action. Switch Trust MCP server: https://github.com/sandbox-quantum/switch-trust-mcp. Switch Trust Python SDK: https://github.com/sandbox-quantum/switch-trust-sdk-py. These repositories are the current development line, not the released product: prefer these docs for released behavior, and name the version if you quote code. In the Switch Rooms repository, ignore docs/official/, which is a generated copy of this site.

# Manage a workspace

> Set rules that apply to a whole Switch workspace, such as how long it keeps messages

Some settings apply to a whole workspace. An [admin](https://docs.switchagents.ai/switch-rooms/resources/glossary.md#admin) of the workspace manages them under **Settings › General**, in the [Gateway](https://docs.switchagents.ai/switch-rooms/resources/glossary.md#gateway), the server's browser dashboard. Switch Console doesn't have them.

Before Switch 0.32, these settings were on the Gateway's **Workspace** page. That page is now split between **Settings › General** and **Settings › Users**.

**You must be an admin of this workspace yourself.** A server administrator who isn't a member of the workspace can't change these settings, and neither can an organization admin. The one exception: any admin can turn message retention off.

To turn connectors on for a new workspace, see [Turn on connectors for your workspace](https://docs.switchagents.ai/switch-rooms/getting-started/connectors/index.md#turn-on-connectors-for-your-workspace).

## Decide how long to keep messages [Admin](https://docs.switchagents.ai/switch-rooms/resources/glossary.md#admin)

With retention on, Switch deletes messages older than the number of days you choose, from 1 to 3,650. Until an admin turns it on, a workspace keeps every message.

Switch checks every hour and deletes older messages, including the copies kept for agents. Their files follow about a day later. Room documents aren't deleted.

Agent session text, which can include what people typed to an agent, follows its own schedule: Switch deletes it after seven days, whatever you choose here.

Copies already posted to a messaging app, such as Slack, aren't deleted. Delete those in each app. Copies in server backups stay until those backups expire. If a backup is restored, Switch deletes the older messages again within the hour.

**1. Open the workspace settings**

In the Gateway, select **Settings › General**.

**2. Choose how long to keep messages**

Under data retention, choose to delete messages older than 30, 90, or 365 days, or enter your own number of days.

**3. Confirm**

Confirm that you want to turn retention on.

## Delete an empty workspace [Admin](https://docs.switchagents.ai/switch-rooms/resources/glossary.md#admin)

Only an empty workspace can be deleted, and never the server's default workspace, where new accounts start.

**1. Empty the workspace**

Remove its rooms, agents, resources, machines, connectors, messaging apps, and other users. If you try to delete a workspace that isn't empty, Switch lists what's still in it.

**2. Open the page for your workspace**

In the Gateway, select **Settings › General**.

**3. Choose to delete it**

Choose to delete the workspace.

**4. Confirm**

Type the name of the workspace to confirm.

## Next steps

> [card] [People and agents](https://docs.switchagents.ai/switch-rooms/administer/people-and-agents.md)
>
> Add and remove people, and delete everything someone sent
