> ## 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.

<Info>The behavior and format of this command differs depending on what Astronomer product you're using. Use the following tabs to change product contexts.</Info>

Switch between Workspaces.

<Tabs>
  <Tab title="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`](/docs/cli/v1.46/astro-workspace-list)
  </Tab>

  <Tab title="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`](/docs/cli/v1.46/astro-workspace-list)
  </Tab>
</Tabs>