Bouncers

List bouncers

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 read_branch, delete_branch, create_branch, connect_production_branch, connect_branch

OAuth Scopes

ResourceScopes
Organizationread_branches
Databaseread_branches
Branchread_branch
get/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.

Query parameters

pageinteger

If provided, specifies the page offset of returned results

per_pageinteger

If provided, specifies the number of returned results

Response

Returns bouncers

typestring required

The response type. Always "list" for paginated responses.

current_pageinteger required

The current page number

per_pageinteger required

The maximum number of results per page

next_pageinteger nullable required

The next page number, or null when this is the last page

next_page_urlstring nullable required

The next page of results, or null when this is the last page

prev_pageinteger nullable required

The previous page number, or null when this is the first page

prev_page_urlstring nullable required

The previous page of results, or null when this is the first page

Changes

Changed in 8 of the 24 revisions of this API.9211

    • removed the required property data/items/parameters/items/step from the response with the 200 status

      response-required-property-removed

    • added the required property per_page to the response with the 200 status

      response-required-property-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

    • the response property data/items/branch/deleted_at became nullable for the status 200

      response-property-became-nullable

    • the response property data/items/deleted_at became nullable for the status 200

      response-property-became-nullable

    • the response property next_page became nullable for the status 200

      response-property-became-nullable

    • the response property next_page_url became nullable for the status 200

      response-property-became-nullable

    • the response property prev_page became nullable for the status 200

      response-property-became-nullable

    • the response property prev_page_url became nullable for the status 200

      response-property-became-nullable

    • added the required property type to the response with the 200 status

      response-required-property-added

  • 3c33e46f8ff212See the full diff
    • added the new string enum value to the data/items/parameters/items/parameter_type response property for the response status 200

      response-property-enum-value-added

    • removed the internal enum value from the data/items/parameters/items/parameter_type response property for the response status 200

      response-property-enum-value-removed

    • added the required property data/items/parameters/items/immutable to the response with the 200 status

      response-required-property-added

    • removed the boolean enum value from the data/items/parameters/items/parameter_type response property for the response status 200

      response-property-enum-value-removed

    • removed the bytes enum value from the data/items/parameters/items/parameter_type response property for the response status 200

      response-property-enum-value-removed

    • removed the float enum value from the data/items/parameters/items/parameter_type response property for the response status 200

      response-property-enum-value-removed

    • removed the string enum value from the data/items/parameters/items/parameter_type response property for the response status 200

      response-property-enum-value-removed

    • removed the time enum value from the data/items/parameters/items/parameter_type response property for the response status 200

      response-property-enum-value-removed

    This revision also has 4 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

    • for the query request parameter page, the type/format was changed from number/ to integer/

      request-parameter-type-changed

    • for the query request parameter per_page, the type/format was changed from number/ to integer/

      request-parameter-type-changed

    • removed the milliseconds enum value from the data/items/parameters/items/parameter_type response property for the response status 200

      response-property-enum-value-removed

  • 5f2529ef1c8611See the full diff
    • added the new replica_az_affinity enum value to the data/items/target response property for the response status 200

      response-property-enum-value-added

    • added the required property data/items/sku to the response with the 200 status

      response-required-property-added