This function permanently deletes a single item from the .trash directory in the current cPanel account's home directory.

Note: Unlike the Fileman::fileop function with op=unlink, this function uses a non-safe recursive delete, so it removes permission-locked entries instead of skipping them silently and reporting them as deleted. Such an entry might be a 0444 file or a 0555 subdirectory preserved from a backup.

If the target is already absent, the function reports an idempotent success rather than an error. On success, it also prunes the stale line for the removed item, if there is one, from the trash's restore map.

{
  "apiversion": 3,
  "func": "remove",
  "module": "Trash",
  "result": {
    "data": {
      "removed": true
    },
    "status": 1
  }
}