# Delete a WordPress installation permanently

This function permanently deletes a WordPress installation that the caller
owns. It removes the site's files and its database.

  Note:

  - This action cannot be undone. There is no recycle bin, and the system
    keeps no copy of the files or the database.
  - The onboarding flow calls this to clear an existing installation before
    it retries create_website. When create_website reports a
    collision, call this function once for each entry in the
    existing_installations field, then call create_website again.
  - This function is not idempotent. A second call for the same id
    parameter fails, because the installation no longer exists.
  - The system verifies that the caller owns the installation before it
    deletes anything. An installation that belongs to another account is
    indistinguishable from one that does not exist.

Endpoint: POST /WPX/remove_installation
Version: 11.138.0.10
Security: BasicAuth

## Request fields (application/x-www-form-urlencoded):

  - `id` (integer, required)
    The WordPress Toolkit installation id, as returned in the wptk_id field of list_websites.
    Example: 17

## Response 200 fields (application/json):

  - `apiversion` (integer)
    The version of the API.
    Example: 3

  - `func` (string)
    The name of the method called.
    Example: "remove_installation"

  - `module` (string)
    The name of the module called.
    Example: "WPX"

  - `result` (object)

  - `result.data` (object)
    Confirmation that the system deleted the installation.

  - `result.data.id` (integer)
    The installation id that the system deleted.
    Example: 17

  - `result.data.removed` (integer)
    Always 1. A failure returns a failure status with a message in the errors field instead.
    Enum: 1

  - `result.errors` (array,null)
    List of errors if the API failed.

  - `result.messages` (array,null)
    List of messages generated by the API.

  - `result.metadata` (object)

  - `result.metadata.transformed` (integer)
    Post-processing may have transformed the data.
    Enum: 1

  - `result.status` (integer)
    - 1 - Success.
- 0 - Failed: Check the errors field for more details.
    Enum: 1, 0

  - `result.warnings` (array,null)
    List of warnings generated by the API. Warnings describe non-critical failures or other problematic conditions noted while running an API.