--- title: Remove account description: Removes a vPanel user account --- import { Callout, Tabs, Cards, Table } from "nextra/components"; import { XCircle, Key, CornerDownLeft, UserPlus } from "react-feather"; import { JsonOnly, XmlOnly } from "@/components/ApiSwitcher"; import { GreenText } from "@/components/Text"; # Remove account You will first have to [suspend the account](/accounts/suspend) before you can remove it. This endpoint removes the vPanel user account associated with the provided information. ## HTTP Endpoint
{/* prettier-ignore */}


    ```console copy filename="URL"
    https://panel.myownfreehost.net/json-api/removeacct.php
    ```

{/* prettier-ignore */}


    ```console copy filename="URL"
    https://panel.myownfreehost.net/xml-api/removeacct.php
    ```

## Parameters `user` is the username you provided when creating the user account using [createacct.php](/accounts/create). This is **not** the vPanel username (hname_12345678).
Parameter Required Type `user` Yes string

## Usage ```bash copy showLineNumbers filename="Shell" curl -X POST -u username:password -d "user=username" "https://panel.myownfreehost.net/json-api/removeacct.php" ``` ```python copy showLineNumbers filename="Python" import requests from requests.auth import HTTPBasicAuth url = "https://panel.myownfreehost.net/json-api/removeacct.php" data = {'user': 'username'} # For the username, use the same username you set when creating the account. response = requests.post(url, params=data, auth=HTTPBasicAuth('username', 'password')) print(response.json()) # Do this if you only want to get the status code. print(response.json()["result"][0]["status"]) ``` ```bash copy showLineNumbers filename="Shell" curl -X POST -u username:password -d "user=username" "https://panel.myownfreehost.net/xml-api/removeacct.php" ``` ```python copy showLineNumbers filename="Python" import requests from requests.auth import HTTPBasicAuth from xml.etree.ElementTree import fromstring, ElementTree # Do this if you only want to get the status code. url = "https://panel.myownfreehost.net/xml-api/removeacct.php" data = {'user': 'username'} # For the username, use the same username you set when creating the account. response = requests.post(url, params=data, auth=HTTPBasicAuth('username', 'password')) print(response.text) # Do this if you only want to get the status code. tree = ElementTree(fromstring(response.content)) root = tree.getroot() for child in root: print(child[0].text) # The status code (can either be 0 or 1) ``` ## Response ```json copy showLineNumbers filename="Response" { "result": [ { "statusmsg": "username account removed", "rawout": "username queued for removal", "status": 1 } ] } ``` ```xml copy filename="Response" 1 username account has been unsuspended ``` --- ### Related pages: } title="Create account" href="/accounts/create" /> } title="Errors" href="/errors" /> } title="Authentication" href="/authentication" />
} title="Hosting account callbacks: account deletion" href="/callbacks/hostingAccount#account-deletion" />