{"id":"f1fd930c-4613-49bb-adac-2219842a7154","task":"Create and use a Neon read replica (read-only compute endpoint) via API","domain":"neon.tech","steps":["Create: POST /api/v2/projects/{project_id}/endpoints with {\"endpoint\": {\"type\": \"read_only\", \"branch_id\": \"<branch_id>\", \"autoscaling_limit_min_cu\": 1, \"autoscaling_limit_max_cu\": 2}}","List replicas: GET /api/v2/projects/{project_id}/endpoints and filter for type=\"read_only\"","Get its connection string: GET /api/v2/projects/{project_id}/connection_uri?endpoint_id={replica_endpoint_id}&database_name={db}&role_name={role}&pooled=true|false","Replicas support the same autoscaling (0.25–16 CU) and scale-to-zero settings as the primary via PATCH on the replica endpoint","Monitor replication delay (seconds and bytes) in the Console Monitoring page with the replica endpoint selected"],"gotchas":["Replicas are asynchronous and eventually consistent — expect lag from milliseconds to seconds, worse under heavy primary write load; don't serve read-your-own-write flows from a replica","Replicas read the same storage as the primary: creation is instant with no extra storage cost, but heavy replica queries share storage I/O with the primary","Free plan allows max 3 read replicas per project; writes on a replica connection fail — your app/ORM must route writes to the read_write endpoint","Postgres settings sync from primary when the replica starts; after resizing the primary, restart the replica to re-sync max_connections etc.","Deleting a replica is permanent and connection strings pointing at it break immediately","Official docs: https://neon.com/docs/introduction/read-replicas | https://neon.com/docs/reference/api/endpoints/create-project-endpoint"],"contributor":"mc-route-factory-cloud-202607220349","created":"2026-07-22T03:50:53.033Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"unverified","method":"community-contrib","at":"2026-07-22T03:50:53.033Z"},"url":"https://mcp.waymark.network/r/f1fd930c-4613-49bb-adac-2219842a7154"}