---
title: "Delete a WordPress installation permanently"
method: POST
path: "/WPX/remove_installation"
tags: ["WPX"]
---

# Delete a WordPress installation permanently

`POST /WPX/remove_installation`

## Request

- Base URL: `https://cpanel-server.tld:2083/execute`
- URL: `https://cpanel-server.tld:2083/execute/WPX/remove_installation`
- Auth: HTTP basic

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.

## Request body `application/x-www-form-urlencoded`

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

## Response `200`

The HTTP request was successful.

- object
  - `apiversion` integer: The version of the API.
  - `func` string: The name of the method called.
  - `module` string: The name of the module called.
  - `result` object
    - `data` object: Confirmation that the system deleted the installation.
      - `id` integer: The installation id that the system deleted.
      - `removed` 1: Always `1`. A failure returns a failure status with a message in the `errors` field instead.
    - `errors` string[], nullable: List of errors if the API failed.
    - `messages` string[], nullable: List of messages generated by the API.
    - `metadata` object
      - `transformed` 1: Post-processing may have transformed the data.
    - `status` 1 | 0: - `1` - Success. - `0` - Failed: Check the errors field for more details.
    - `warnings` string[], nullable: List of warnings generated by the API. Warnings describe non-critical failures or other problematic conditions noted while running an API.

## Changes

- **2026-09-23** `aed66b1a51cc`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/cpanel/apis/cpanel-uapi/changes/WPX/remove_installation/post.md)

---

[API](https://skmtc.dev/cpanel/apis/cpanel-uapi.md) - [All operations](https://skmtc.dev/cpanel/apis/cpanel-uapi/llms.txt) - [OpenAPI document](https://skmtc.dev/cpanel/apis/cpanel-uapi/revisions/05239220da37?raw)