# Update PostgreSQL database name

This function changes a PostgreSQL® database's name.

Warning:

  The system requires more time to rename larger and more complex databases.

Important:

  When you disable the PostgreSQL role, the system disables this function.

Endpoint: GET /rename_postgresql_database
Version: 11.136.0.22
Security: BasicAuth

## Query parameters:

  - `newname` (string, required)
    The database's new name.

Warning:
If database prefixing is enabled, this parameter must include the database prefix for the account.
    Example: "database2"

  - `oldname` (string, required)
    The database's current name.
    Example: "database"

  - `cpuser` (string)
    The database's owner.
    Example: "username"

## Response 200 fields (application/json):

  - `metadata` (object)

  - `metadata.command` (string)
    The method name called.
    Example: "rename_postgresql_database"

  - `metadata.reason` (string)
    The reason the API function failed when the metadata.result field is 0. This field may display a success message when a function succeeds.
    Example: "OK"

  - `metadata.result` (integer)
    * 1 — Success.
* 0 — Failed. Check the reason field for more details.
    Enum: 0, 1

  - `metadata.version` (integer)
    The version of the API function.
    Example: 1