v17

latestOpenAPI 3.0.1raw.githubusercontent.com2026-07-08165682.0 MB
Bouncers

Create a bouncer

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

ResourceScopes
Organizationwrite_databases
Databasewrite_database
post/organizations/{organization}/databases/{database}/branches/{branch}/bouncers

Path parameters

organizationstring required

Organization name slug from list_organizations. Example: acme.

databasestring required

Database name slug from list_databases. Example: app-db.

branchstring required

Branch name from list_branches. Example: main.

Request body

namestring

The bouncer name

targetstring

The type of server the bouncer targets

bouncer_sizestring

The size SKU for the bouncer

replicas_per_cellinteger

The number of replica servers per cell

Response

Returns the new bouncer

idstring required

The ID of the bouncer

namestring required

The name of the bouncer

target'primary' | 'replica' | 'replica_az_affinity' required

The instance type the bouncer targets

replicas_per_cellinteger required

The count of replicas in each cell

created_atstring required

When the bouncer was created

updated_atstring required

When the bouncer was updated

deleted_atstring nullable required

When the bouncer was deleted