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

# auth switch

> Switch active authentication profile

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

Switch the active authentication profile. If no profile name is provided, an interactive selector is shown listing all available profiles. The active profile determines which API token and organization are used for subsequent commands.

## Usage

## Options

Option

Description

Required

Default

`<name>`

Name of the profile to switch to. If omitted, an interactive selector is shown.

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 profile "production".`). If the profile is not found, exits with an error.