user/listuserpermissions
Description
Lists all available user permissions. User permissions are expected to be used when working with an subuser, for example when using the user/addsubuser and user/editsubuserprivileges API functions. This list is pulled real-time directly from the SPanel system.
Parameters
Field | Type | Required | Description |
---|---|---|---|
token | string | Yes | Authorizing API token – check API Basics for more information. |
accountuser | string | Yes | The SPanel user account that is being managed or viewed. |
action | string | Yes | The category and function being executed. |
labels | bool | No | Default: false (unset). If set to true, API call results will include human-readable labels for each category and its pages. |
Warning
The user permissions are subject to change overtime as we add new features to SPanel. A good idea is to run a cron to update these permissions in your system regularly if you are using some form of caching.
Info
Please note that the permission list differs from the categories and pages placement that you can see in the SPanel UI because of the way the functions are organized into categories in the SPanel API.
Example
$endpointUrl = 'https://123.123.123.123/spanel/api.php';
$postData = [
'token' => 'provided_auth_token', // Check API Basics for more information
'accountuser' => 'spanelio',
'action' => 'user/listuserpermissions',
//'labels' => true
];
$ch = curl_init();
curl_setopt( $ch, CURLOPT_URL, $endpointUrl);
curl_setopt( $ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt( $ch, CURLOPT_POST, true);
curl_setopt( $ch, CURLOPT_POSTFIELDS, http_build_query($postData));
curl_setopt( $ch, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt( $ch, CURLOPT_SSL_VERIFYHOST, false);
$jsonOutput = curl_exec( $ch );
Code language: PHP (php)
You can find more information about the Endpoint URL in our API Basics article.
Output
{
"result": "success",
"data": {
"email": {
"category": "email",
"pages": [
"accounts",
"forwarders",
"mailroute",
"catchall",
"webmaillogin",
"autoresponders",
"spamassassin",
"filters"
]
},
"mysql": {
"category": "mysql",
"pages": [
"databases",
"getphpmyadmin"
]
},
"user": {
"category": "user",
"pages": [
"manageusers",
"pwreset",
"language",
"contactmail",
"loginsecurity"
]
},
"domain": {
"category": "domain",
"pages": [
"domains",
"subdomains",
"dnseditor",
"redirects"
]
},
"file": {
"category": "file",
"pages": [
"ftpaccounts",
"backups",
"restorebackup",
"getftpmanager",
"diskusage"
]
},
"tool": {
"category": "tool",
"pages": [
"ssl",
"cron",
"phpmanager",
"phpinieditor",
"resourceusage"
]
},
"software": {
"category": "software",
"pages": [
"wpmanager",
"joomlamanager",
"nodejsmanager",
"getsoftaculous"
]
}
}
}
Code language: JSON / JSON with Comments (json)