Self Help Documentation
< All Topics

admin/updateadminpermissions

PostedMarch 2, 2022
UpdatedApril 26, 2023

Description

Updates the permissions of an existing SPanel admin account.

Parameters

Additional parameters:

FieldTypeRequiredDescription
tokenstringYesAuthorizing API token – check API Basics for more information.
actionstringYesThe category and function being executed.
usernamestringYesAdmin account username.
permissionsstring|arrayYesPermissions array or ‘all’ string for full root permissions.

When using a permissions array, you can set the category sub-array to ‘all’ string to include every child page available or use an array with every page that you wish to include, for example:
  • If you use [ 'server' => 'all' ], all pages under server category will be included in the newly created user permissions list;
  • If you use [ 'server' => [ 'information', 'status' ] ], the newly created user will access only the pages specified.
Check the full API call example below for further clarification.

Info
The structure and an always up-to-date list of all available admin user permissions can be obtained by running the admin/listadminuserpermissions API call. The list is pulled directly from SPanel’s system in real-time.

Example

PHP
PHP
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
$endpointUrl = 'https://123.123.123.123/spanel/api.php';
 
$postData = [
  'token' => 'provided_auth_token', // Check API Basics for more information
  'action' => 'admin/updateadminpermissions',
  'username' => '[email protected]',
  //'permissions' => 'all' //Set all permissions
  'permissions' => [
                       'server' => 'all' //access every server page
                       'accounts' => [ 'manage', 'create' ] //access only the 'manage' and 'create' pages
                   ]
];
 
$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 );

Output

JSON
PHP
1
2
3
4
5
6
{
    "result": "success",
    "data": {
        "msg": "The admin account with username [email protected] has been created successfully"
    }
}
Table of Contents