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

<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.38/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.38/astro-workspace-list)
  </Tab>
</Tabs>