Server Administration
Server Nodes
Repair distributed accounts with data loss
This function converts cPanel accounts that use a given child node to use the local server instead.
Unlike the WHM API 1 modifyacct API call, this API does not transfer users’ data from the child node as part of the conversion. This API is useful for emergency repairs if, for example, a child node goes permanently offline while accounts still use it.
Warning:
Because this API does not transfer users’ data from the child node, all converted users will lose data. You should only call this API as a last resort.
get/force_dedistribution_from_node
Query parameters
node_aliasstring required
Example:mailalias
The child node’s alias (friendly name). This is the value passed in the WHM API 1 link_server_node_with_api_token function’s alias parameter.
userstring[] required
The usernames of the distributed cPanel accounts to convert.
[ "username", "username1" ]
Response
HTTP Request was successful.
Example response
{
"data": {
"log": [
{
"contents": "Converting “username1” …",
"type": "success"
}
],
"user_info": [
{
"username": "username1"
}
]
},
"metadata": {
"command": "force_dedistribution_from_node",
"reason": "OK",
"result": 1,
"version": 1
}
}