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

# astro workspace switch

> Switch between Workspaces.

> [!NOTE]
>
> The behavior and format of this command differs depending on what Astronomer product you're using. Use the following tabs to change product contexts.

Switch between Workspaces.

**Astro**

## Usage

```sh wrap theme={null}
astro workspace switch
```

## Options

| Option | Description | Valid Values |
| - | - | - |
| `<workspace_id>` (Optional) | The ID of the Workspace you want to switch to. If not specified, the CLI prompts you to choose one. | Any valid Workspace ID |

## Example

Run `astro workspace switch <workspace-id>` to switch between Workspaces.

```sh wrap theme={null}
astro workspace switch clqw6uskr000008l9370y04jd
```

You can find a Workspace's ID by running `astro workspace list`, or by opening your Workspace and going to **Workspace Settings** > **General** in the Astro UI. On Astro, if you don't provide a Workspace ID, the CLI prompts you to pick from a list of Workspaces that you belong to in your current Organization.

## Related commands

* [`astro workspace list`](https://astronomer.io/docs/cli/v1.47/astro-workspace-list)

**APC**

## Usage

```sh wrap theme={null}
astro workspace switch <options>
```

You can find a Workspace's ID by running `astro workspace list`.

## Options

| Option | Description | Valid Values |
| - | - | - |
| `<workspace_id>` | The ID of the workspace you want to switch to. Otherwise, the CLI prompts you to choose one. | Any valid Workspace ID |
| `-p`, `--paginated` | Choose whether or not to paginate the list of available Workspaces. | `TRUE` or `FALSE` |
| `-s`, `--page-size` | The length of the list per page when paginate is set to `TRUE`. | Any integer |

## Related commands

* [`astro workspace list`](https://astronomer.io/docs/cli/v1.47/astro-workspace-list)