> For the complete documentation index, see [llms.txt](https://docs.biodock.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.biodock.ai/workspaces/workspaces.md).

# Workspaces

*What you'll get: what a workspace is, how it differs from your personal account, and how to switch between them.*

A workspace is a shared space for a lab or team. It has its own files, projects, analyses, scripts, molecule runs, credits and storage. The people you invite work in it together.

## Your personal account and your workspaces

Everyone has a **personal account**. It is yours alone: nobody else sees its files, projects, analyses, credits or storage unless you share an item.

A workspace sits next to your personal account and is completely separate from it:

* **Its own data.** Everything made in a workspace belongs to the workspace. Nothing moves or copies between a workspace and your personal account.
* **Its own credits and storage.** Work you do in a workspace is paid for by the workspace, never by your personal account. See [Credits, storage and billing](https://docs.biodock.ai/workspaces/workspaces/credits-storage-and-billing.md).
* **Its own people.** Each member is an **Owner**, **Admin** or **Member**. See [Members and roles](https://docs.biodock.ai/workspaces/workspaces/members-and-roles.md).

Joining or leaving a workspace never changes your personal account.

## Switch between your accounts

1. Click the account switcher at the top right of any page. It shows **Personal** in your personal account, or the workspace's name inside a workspace.
2. Pick **Personal**, or a workspace under **Workspaces**. Your role is shown next to each workspace.

Biodock opens that account's Home page. Inside a workspace, the address starts with `app.biodock.ai/w/<workspace-url>/`.

<figure><img src="https://3806122466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fk3DfNQKoMy1JXdaDLvpG%2Fuploads%2Fgit-blob-5c406e3e8349b58d715be7a31dbc00cfcb1f1313%2Fdocs-workspaces-switch.gif?alt=media" alt="Click the account switcher, choose a workspace under Workspaces, the workspace&#x27;s Home page opens, then open the switcher again and choose Personal"><figcaption><p>Open the account switcher and pick <strong>Personal</strong> or a workspace under <strong>Workspaces</strong>.</p></figcaption></figure>

The switcher menu also lists **Invitations** waiting for you, each with a **Join** button, and **Create a workspace**.

Inside a workspace, the sidebar shows the workspace's own items and a **Workspace** group with **Members**, **Credits & usage** and, for owners and admins, **Settings**. **My Account** and **API keys** stay under **Personal**: they always belong to you, not to the workspace.

{% hint style="info" %}
**Don't see the account switcher, or Create a workspace?** The switcher appears once you're in a workspace, have an invitation, or can create workspaces. If **Create a workspace** isn't in it, creating workspaces isn't available on your account yet: ask a workspace owner or admin to invite you, or email <support@biodock.ai>.
{% endhint %}

## Was your team moved into a workspace?

Biodock no longer has teams. If you were on a team, Biodock moved it into a workspace:

* **The team's files, projects, analyses, credits and storage are now the workspace's.** Switch to the workspace to find them. Your own files may be in a folder with your name, *"\<your name>'s files"*.
* **You got a new, empty personal account** next to it, with its own credits and storage.
* **People outside the team keep what was shared with them**, in their own account. They are not members of the workspace. See [Sharing and visibility](https://docs.biodock.ai/workspaces/workspaces/sharing-and-visibility.md#shared-before-this-team-became-a-workspace).
* **Your API keys moved with you.** They now act in the workspace. See the next section.

## Using the API, Claude or ChatGPT with a workspace

* **Public API:** API keys are personal and act in your personal account. To act in a workspace you're a member of, add the header `X-Biodock-Workspace: <workspace-url>` to your requests. A key that moved into a workspace with your team acts in that workspace without the header. See [Authentication](https://docs.biodock.ai/public-api/authentication.md).
* **Claude or ChatGPT (MCP):** a connection acts in your personal account. To connect to a workspace, use `https://app.biodock.ai/mcp?workspace=<workspace-url>` as the server URL. Owners and admins can turn MCP connections off for the workspace in [Workspace settings](https://docs.biodock.ai/workspaces/workspaces/workspace-settings.md#switches).
* **Ask Biodock:** inside a workspace it can read the documentation, the workspace's storage, and the projects you can open. It can't see the workspace's files, analyses or molecule runs yet. Its answers are paid from the workspace's credits.

## If a workspace is suspended

Biodock can suspend a workspace. Its members then see *"This workspace is suspended, so nobody can open it until Biodock reactivates it. Your own account is not affected."* Work that was already running carries on. Contact <support@biodock.ai> if you have questions.

## In this section

* [Create a workspace](https://docs.biodock.ai/workspaces/workspaces/create-a-workspace.md)
* [Members and roles](https://docs.biodock.ai/workspaces/workspaces/members-and-roles.md)
* [Sharing and visibility](https://docs.biodock.ai/workspaces/workspaces/sharing-and-visibility.md)
* [Credits, storage and billing](https://docs.biodock.ai/workspaces/workspaces/credits-storage-and-billing.md)
* [Workspace settings](https://docs.biodock.ai/workspaces/workspaces/workspace-settings.md)
* [Sharing in your personal account](https://docs.biodock.ai/workspaces/sharing-in-your-personal-account.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.biodock.ai/workspaces/workspaces.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
