---
title: "[Beta] Set up a read replica"
method: POST
path: "/v1/projects/{ref}/read-replicas/setup"
tags: ["Database"]
---

# [Beta] Set up a read replica

`POST /v1/projects/{ref}/read-replicas/setup`

## Path parameters

- `ref` string, required

## Request body

- SetUpReadReplicaBody
  - `read_replica_region` 'us-east-1' | 'us-east-2' | 'us-west-1' | 'us-west-2' | 'ap-east-1' | 'ap-southeast-1' | 'ap-northeast-1' | 'ap-northeast-2' | 'ap-southeast-2' | 'eu-west-1' | 'eu-west-2' | 'eu-west-3' | 'eu-north-1' | 'eu-central-1' | 'eu-central-2' | 'ca-central-1' | 'ap-south-1' | 'sa-east-1', required — Region you want your read replica to reside in

## Response `204`

## Other responses

- `401` — Unauthorized
- `402` — This feature requires the Pro, Team, or Enterprise organization plan.
- `403` — Forbidden action
- `429` — Rate limit exceeded
- `500` — Failed to set up read replica

---

[API](https://skmtc.dev/supabase/apis/management-api.md) · [All operations](https://skmtc.dev/supabase/apis/management-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/supabase/management-api/revisions/a7cb39418064/schema)