---
title: "replicas delete"
description: "Remove a read replica"
canonical: "https://pgbeam.com/docs/cli/projects/replicas/delete"
last-updated: "2026-09-14T19:37:21.000Z"
---

# replicas delete

> Remove a read replica

URL: https://pgbeam.com/docs/cli/projects/replicas/delete

Remove a read replica from a database. PgBeam will stop routing queries to this replica. The upstream replica server is not affected. A confirmation prompt is shown unless `--yes` is passed.

## Usage

## Options

Option

Description

Required

Default

`<id>`

ID of the replica to remove

Yes

-

`--database-id <value>`

ID of the database that owns the replica

Yes

-

`--yes`, `-y`

Skip the confirmation prompt

No

`false`

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 replica was deleted.