PgBeam Docs
Projects

Delete a replica

DELETE
/v1/databases/{database_id}/replicas/{replica_id}

Removes a read replica from a database.

Authorization

AuthorizationBearer <token>

JWT issued by Better Auth. Verified via JWKS.

In: header

Path Parameters

database_id*string

Unique database identifier (prefixed, e.g. db_xxx).

replica_id*string

Unique replica identifier (prefixed, e.g. rep_xxx).

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X DELETE "https://example.com/v1/databases/string/replicas/string"
Empty
{  "error": {    "code": "string",    "message": "string"  }}
{  "error": {    "code": "string",    "message": "string"  }}
{  "error": {    "code": "string",    "message": "string"  }}
{  "error": {    "code": "string",    "message": "string"  }}
{  "error": {    "code": "string",    "message": "string"  }}