Create or update reseller privilege settings
This function creates or modifies an Access Control List (ACL).
Note:
For each acl-* parameter, any value adds that privilege to the ACL list and no value removes that privilege from the ACL list.
Warning:
We strongly recommend that WHM users create and edit ACLs and ACL privileges through WHM's Edit Reseller Nameservers and Privileges interface ( WHM >> Home >> Resellers >> Edit Reseller Nameservers and Privileges ).
Query parameters
The reseller's username.
Whether to allow the reseller to view an account summary.
Whether to allow the reseller to add and remove hosting plans (packages).
Whether to allow the reseller to create packages with a dedicated IP address.
Whether to allow the reseller to create packages with shell access.
Whether to grant the reseller all ACL privileges.
Warning:
A value of 1 grants root-level privileges to the reseller.
Whether to allow the reseller to create packages with addon domains.
Whether to allow the reseller to create packages with parked domains (aliases).
Whether to allow the reseller to create packages with unlimited bandwidth.
Whether to allow the reseller to create packages with unlimited disk space.
Whether to allow the reseller to create packages with unlimited features.
Whether to allow the reseller to retrieve basic system information.
Whether to allow the reseller to access basic cPanel & WHM options.
Whether to allow the reseller to use DNS clusters.
Whether to allow the reseller to perform Cross-Origin Resource Sharing (CORS) HTTP requests.
Whether to allow the reseller to execute cPanel API 1, cPanel API 2 and UAPI functions via WHM.
Whether to allow the reseller to manage how their server and its services connect to other servers and services.
Whether to allow the reseller to create accounts.
Whether to allow the reseller to add DNS zones.
Whether to allow the reseller to create a temporary session user for a specified service.
Note:
This privilege allows an API token user to bypass any restrictions that you set on the API token. For more information, read our Manage API Tokens documentation.
Whether to allow the reseller to enable demo mode for accounts.
Whether to allow the reseller to manage Digest Authentication support.
Whether to allow the reseller to create accounts with shell access.
Whether to allow the reseller to edit accounts.
Whether to allow the reseller to edit DNS zones.
Whether to allow the reseller to edit MX entries.
Whether to allow the reseller to edit hosting plans (packages).
Whether to allow the reseller to generate a mobile configuration profile for an email account.
Whether to allow the reseller to terminate accounts.
Whether to allow the reseller to remove DNS zones.
Whether to allow the reseller to modify bandwidth limits (quotas).
Warning:
If you do not use resource limits, a value of 1 allows resellers to circumvent package limits for disk space.
Whether to allow the reseller to view the list of accounts.
Whether to allow the reseller to view existing hosting plans (packages).
Whether to allow the reseller to create and modify locales on the server.
Whether to allow the reseller to troubleshoot mail delivery.
Whether to allow the reseller to manage API tokens.
Note:
This privilege allows an API token user to bypass any restrictions that you set on the API token. For more information, read our Manage API Tokens documentation.
Whether to allow the reseller to manage DNS records.
Whether to allow the reseller to manage external authentication for their accounts.
Whether to allow the reseller to manage their server's cPanel styles.
Whether to allow the reseller to retrieve MySQL® database and user data.
Whether to allow the reseller to manage nameservers.
Whether to allow the reseller to modify the server's news.
Whether to allow the reseller to park DNS zones.
Whether to allow the reseller to change passwords.
Note:
This privilege allows an API token user to change account passwords and log in with a new password. For more information, read our Manage API Tokens documentation.
Whether to allow the reseller to modify quotas.
Warning:
If you do not use resource limits, a value of 1 allows resellers to circumvent package limits for disk space.
Whether to allow the reseller to rearrange accounts.
Whether to allow the reseller to resync FTP passwords.
Whether to allow the reseller to restart services.
Whether to allow the reseller to view account bandwidth usage.
Whether to allow the reseller to perform SSL site management.
Whether to allow the reseller to purchase SSL certificates.
Whether to allow the reseller to generate SSL certificates.
Whether to allow the reseller to view their server's SSL information.
Whether to allow the reseller to view server information.
Whether to allow the reseller to view the server's status.
Whether to allow the reseller to suspend or unsuspend accounts.
Whether to allow the reseller to manage third-party services.
Whether to allow the reseller to view reports about email message delivery attempts from their account.
Whether to allow the reseller to upgrade or downgrade accounts.
Whether to allow the reseller to use all global packages. For more information, read our reseller packages documentation.
The ACL to assign to the reseller.
Warning:
Functions should either use this parameter, or a combination of the acl-* parameters below. Do not include both in a single function.
The reseller's username.
Note:
This parameter is an alias for reseller and is provided for backwards compatibility.
Response
HTTP Request was successful.
Example response
{
"data": {
"acl": [
"all"
]
},
"metadata": {
"command": "setacls",
"reason": "OK",
"result": 1,
"version": 1
}
}