# Delete an application.

This function deletes an application: it stops the application's
running process and removes its container, moves the application's
directory aside to a .bak sibling (kept for verification or rollback
rather than deleted), and removes the application from the account's
registry.

Deleting an application cannot be undone, so it requires an explicit
confirmation: verify must be 1 to proceed. A verify of 0 makes
no changes and returns a confirmation-required error.

The application's domain is not affected; subdomains are managed
independently.

On failure, the metadata.error_category field carries a
machine-readable failure category.

Important:

  The verify parameter is required and has no default. You must
  set it to 1 to confirm this irreversible operation.

Endpoint: GET /WebApp/delete
Version: 11.138.0.10
Security: BasicAuth

## Query parameters:

  - `name` (string, required)
    The application's unique name (slug).
    Example: "my-app"

  - `verify` (integer, required)
    Confirmation that this irreversible deletion should proceed.

* 1 — Confirm and delete: the container is torn down and the
  application's directory is moved aside to .bak (kept for
  verification or rollback, not hard-deleted).
* 0 — Make no changes; the call returns a confirmation-required
  error.

This parameter is required and has no default.
    Enum: 0, 1

## Response 200 fields (application/json):

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

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

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

  - `result` (object)

  - `result.data` (object)

  - `result.data.removed` (integer)
    Whether the application was removed.

* 1 — Removed.
    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.error_category` (string,null)
    The machine-readable failure category. Only present
when status is 0.

* teardown_failed — The system could not fully remove the application (its container or its files); the application remains registered so the deletion can be retried.
* deploy_in_progress — The application has a deploy currently in flight; wait for it to finish or fail, then retry.
    Enum: "teardown_failed", "deploy_in_progress"

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

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