Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 20 additions & 0 deletions get-started/bruno-basics/create-a-workspace.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -146,6 +146,26 @@
For detailed instructions on importing and exporting workspaces, including Git-based workflows, see the [Import/Export Workspace Guide](/get-started/import-export-data/import-export-workspace).
</Tip>

## Moving an External Collection into a Workspace

If a collection was opened from a location outside the workspace folder (for example, you opened it directly from a path on disk), you can move it into the active workspace so it can be managed as part of the workspace's Git setup.

Check warning on line 151 in get-started/bruno-basics/create-a-workspace.mdx

View check run for this annotation

Mintlify / Mintlify Validation (bruno-a6972042) - vale-spellcheck

get-started/bruno-basics/create-a-workspace.mdx#L151

Did you really mean 'workspace's'?

<Info>
The **Move into Workspace** action is only shown for collections that live outside the active workspace's root folder. Collections already inside the workspace will not show this option.

Check warning on line 154 in get-started/bruno-basics/create-a-workspace.mdx

View check run for this annotation

Mintlify / Mintlify Validation (bruno-a6972042) - vale-spellcheck

get-started/bruno-basics/create-a-workspace.mdx#L154

Did you really mean 'workspace's'?
</Info>

To move an external collection into the active workspace:

1. In the sidebar, hover over the collection and open the **collection actions** menu (the three-dot icon).
2. Select **Move into Workspace**.
3. Review the source path and the destination (`<workspace>/collections/<name>`), then click **Move**.

Bruno moves the collection's files into `<workspace>/collections/<name>` and registers the new path in the workspace's `workspace.yml`. The collection is closed and re-opened from its new location, so any open request tabs for that collection will close.

Check warning on line 163 in get-started/bruno-basics/create-a-workspace.mdx

View check run for this annotation

Mintlify / Mintlify Validation (bruno-a6972042) - vale-spellcheck

get-started/bruno-basics/create-a-workspace.mdx#L163

Did you really mean 'workspace's'?

<Warning>
If the collection has unsaved changes, Bruno opens a confirmation dialog listing the affected requests. You can **Save All and Move**, **Discard All and Move**, or save transient (never-saved) requests individually before continuing.
</Warning>

## Closing a Workspace

To close a workspace (remove it from Bruno without deleting files):
Expand Down