---
title: "orgs switch"
description: "Switch active organization"
canonical: "https://pgbeam.com/docs/cli/orgs/switch"
last-updated: "2026-09-14T19:37:21.000Z"
---

# orgs switch

> Switch active organization

URL: https://pgbeam.com/docs/cli/orgs/switch

Switch the active organization for the current authentication profile. All subsequent commands that require an organization will use this org. If no org ID is provided, your organizations are fetched from the API and you pick one interactively (a single visible organization is selected automatically). When the API is unreachable, you are prompted to enter an ID by hand; copy it from the dashboard under Settings > Organization.

## Usage

## Options

Option

Description

Required

Default

`<id>`

Organization ID to switch to. If omitted, you pick from a list.

No

-

All global options (`--token`, `--profile`,
`--project`, `--org`, `--json`, `--no-color`, `--no-trunc`, `--debug`) are
also available on this command.

## Examples

## Output

Prints a confirmation message (e.g. `Switched to organization org_xxx.`).