---
title: "projects update"
description: "Update project settings"
canonical: "https://pgbeam.com/docs/cli/projects/update"
last-updated: "2026-09-14T19:37:21.000Z"
---

# projects update

> Update project settings

URL: https://pgbeam.com/docs/cli/projects/update

Update the settings of an existing project. If no project ID is provided, uses the linked project in the current directory. At least one update flag must be provided. `--agents-disabled` is the project kill-switch: setting it true blocks ALL agent-credential connections (live sessions drop within seconds); passthrough/human connections are unaffected. `--allowed-cidrs` replaces the IP allowlist; pass an empty string to allow all.

## Usage

## Options

Option

Description

Required

Default

`<id>`

Project ID to update. Uses the linked project if omitted.

No

-

`--name <value>`

New display name for the project

No

-

`--description <value>`

New project description

No

-

`--tags <value>`

Comma-separated labels (replaces the current set)

No

-

`--status <value>`

Project lifecycle status: active, suspended, or deleted

No

-

`--allowed-cidrs <value>`

Comma-separated CIDR ranges for the IP allowlist (replaces the current set). Pass an empty string to allow all.

No

-

`--default-policy-profile-id <value>`

Policy profile enforced on passthrough/human connections. Pass an empty string to clear.

No

-

`--agents-disabled <value>`

Project kill-switch. true blocks all agent-credential connections; false re-enables.

No

-

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

## Examples

## Output

Prints a success message confirming the project was updated. With `--json`, returns the updated project object.