Create a switchover
Moves the primary of a Postgres branch.
On a branch with replicas the primary steps down and a replica is
promoted in its place. A branch running a single instance has nothing to
promote, so that instance is restarted where it stands and the branch is
unreachable while it comes back. Read method on the response to see
which one the branch got.
A branch accepts one switchover at a time. A switchover that ends in the
failed state has an unconfirmed outcome: the primary may still have
moved, and nothing is rolled back.
Authorization
A service token or OAuth token must have at least one of the following access or scopes in order to use this API endpoint:
Service Token Accesses
write_database
OAuth Scopes
| Resource | Scopes |
|---|---|
| Organization | write_databases |
| Database | write_database |
Authorizations
Path Parameters
Body
Response
Returns the new switchover

