# Create or update privilege list and settings

This function creates or modifies an Access Control List (ACL).

Note:

  For each acl-* parameter, a value of 1 adds that privilege to the ACL list and a value of 0 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 ).

Endpoint: GET /saveacllist
Version: 11.136.0.4
Security: BasicAuth

## Query parameters:

  - `acllist` (string, required)
    The ACL to assign to the reseller.

Note:

 To modify an existing ACL, set this value to that ACL's name.
    Example: "my_acl_list"

  - `acl-acct-summary` (integer)
    Whether to allow the reseller to view an account summary.
    Enum: 0, 1

  - `acl-add-pkg` (integer)
    Whether to allow the reseller to add and remove hosting plans (packages).
    Enum: 0, 1

  - `acl-add-pkg-ip` (integer)
    Whether to allow the reseller to create packages with a dedicated IP address.
    Enum: 0, 1

  - `acl-add-pkg-shell` (integer)
    Whether to allow the reseller to create packages with shell access.
    Enum: 0, 1

  - `acl-all` (integer)
    Whether to grant the reseller all privileges.

Warning:

 A value of 1 grants root-level privileges to the reseller.
    Enum: 0, 1

  - `acl-allow-addoncreate` (integer)
    Whether to allow the reseller to create packages with addon domains.
    Enum: 0, 1

  - `acl-allow-emaillimits-pkgs` (integer)
    Whether to allow the reseller to create packages with custom email quotas.
    Enum: 0, 1

  - `acl-allow-parkedcreate` (integer)
    Whether to allow the reseller to create packages with parked domains (aliases).
    Enum: 0, 1

  - `acl-allow-shell` (integer)
    Whether to allow the reseller to create accounts with shell access.
    Enum: 0, 1

  - `acl-allow-unlimited-bw-pkgs` (integer)
    Whether to allow the reseller to create packages with unlimited bandwidth.
    Enum: 0, 1

  - `acl-allow-unlimited-disk-pkgs` (integer)
    Whether to allow the reseller to create packages with unlimited disk space.
    Enum: 0, 1

  - `acl-allow-unlimited-pkgs` (integer)
    Whether to allow the reseller to create packages with unlimited features.
    Enum: 0, 1

  - `acl-basic-system-info` (integer)
    Whether to allow the reseller to retrieve basic system information.
    Enum: 0, 1

  - `acl-basic-whm-functions` (integer)
    Whether to allow the reseller to access basic cPanel & WHM options.
    Enum: 0, 1

  - `acl-clustering` (integer)
    Whether to allow the reseller to use DNS clusters.
    Enum: 0, 1

  - `acl-cors-proxy-get` (integer)
    Whether to allow the reseller to perform Cross-Origin Resource Sharing (CORS) HTTP requests.
    Enum: 0, 1

  - `acl-cpanel-api` (integer)
    Whether to allow the reseller to execute cPanel API 1, cPanel API 2 and UAPI functions via WHM.
    Enum: 0, 1

  - `acl-cpanel-integration` (integer)
    Whether to allow the reseller to manage how their server and its services connect to other servers and services.
    Enum: 0, 1

  - `acl-create-acct` (integer)
    Whether to allow the reseller to create accounts.
    Enum: 0, 1

  - `acl-create-dns` (integer)
    Whether to allow the reseller to add DNS zones.
    Enum: 0, 1

  - `acl-create-user-session` (integer)
    Whether to allow the reseller to create a temporary user session for a specified service.

Notes:

 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.
    Enum: 0, 1

  - `acl-demo-setup` (integer)
    Whether to allow the reseller to enable demo mode for accounts.
    Enum: 0, 1

  - `acl-digest-auth` (integer)
    Whether to allow the reseller to manage Digest Authentication support.
    Enum: 0, 1

  - `acl-edit-account` (integer)
    Whether to allow the reseller to edit accounts.
    Enum: 0, 1

  - `acl-edit-dns` (integer)
    Whether to allow the reseller to edit DNS zones.
    Enum: 0, 1

  - `acl-edit-mx` (integer)
    Whether to allow the reseller to edit MX entries.
    Enum: 0, 1

  - `acl-edit-pkg` (integer)
    Whether to allow the reseller to edit hosting plans (packages).
    Enum: 0, 1

  - `acl-generate-email-config` (integer)
    Whether to allow the reseller to generate a mobile configuration profile for an email account.
    Enum: 0, 1

  - `acl-kill-acct` (integer)
    Whether to allow the reseller to terminate accounts.
    Enum: 0, 1

  - `acl-kill-dns` (integer)
    Whether to allow the reseller to remove DNS zones.
    Enum: 0, 1

  - `acl-limit-bandwidth` (integer)
    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.
    Enum: 0, 1

  - `acl-list-accts` (integer)
    Whether to allow the reseller to view the list of accounts.
    Enum: 0, 1

  - `acl-list-pkgs` (integer)
    Whether to allow the reseller to view existing hosting plans (packages).
    Enum: 0, 1

  - `acl-locale-edit` (integer)
    Whether to allow the reseller to create and modify locales on the server.
    Enum: 0, 1

  - `acl-mailcheck` (integer)
    Whether to allow the reseller to troubleshoot mail delivery.
    Enum: 0, 1

  - `acl-manage-api-tokens` (integer)
    Whether to allow the reseller to manage API tokens.

Notes:

 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.
    Enum: 0, 1

  - `acl-manage-dns-records` (integer)
    Whether to allow the reseller to manage DNS records.
    Enum: 0, 1

  - `acl-manage-oidc` (integer)
    Whether to allow the reseller to manage external authentication for their accounts.
    Enum: 0, 1

  - `acl-manage-styles` (integer)
    Whether to allow the reseller to manage their server's cPanel styles.
    Enum: 0, 1

  - `acl-mysql-info` (integer)
    Whether to allow the reseller to retrieve MySQL® database and user data.
    Enum: 0, 1

  - `acl-news` (integer)
    Whether to allow the reseller to modify the server's news.
    Enum: 0, 1

  - `acl-ns-config` (integer)
    Whether to allow the reseller to manage nameservers.
    Enum: 0, 1

  - `acl-park-dns` (integer)
    Whether to allow the reseller to park DNS zones.
    Enum: 0, 1

  - `acl-passwd` (integer)
    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.
    Enum: 0, 1

  - `acl-quota` (integer)
    Whether to allow the reseller to modify quotas.

Warning:

 If you do not use resource limits, this privilege allows resellers to circumvent package limits for disk space.
    Enum: 0, 1

  - `acl-rearrange-accts` (integer)
    Whether to allow the reseller to rearrange accounts.
    Enum: 0, 1

  - `acl-resftp` (integer)
    Whether to allow the reseller to resync FTP passwords.
    Enum: 0, 1

  - `acl-restart` (integer)
    Whether to allow the reseller to restart services.
    Enum: 0, 1

  - `acl-show-bandwidth` (integer)
    Whether to allow the reseller to view account bandwidth usage.
    Enum: 0, 1

  - `acl-ssl` (integer)
    Whether to allow the reseller to perform SSL site management.
    Enum: 0, 1

  - `acl-ssl-buy` (integer)
    Whether to allow the reseller to purchase SSL certificates.
    Enum: 0, 1

  - `acl-ssl-gencrt` (integer)
    Whether to allow the reseller to generate SSL certificates.
    Enum: 0, 1

  - `acl-ssl-info` (integer)
    Whether to allow the reseller to view their server's SSL information.
    Enum: 0, 1

  - `acl-stats` (integer)
    Whether to allow the reseller to view server information.
    Enum: 0, 1

  - `acl-status` (integer)
    Whether to allow the reseller to view the server's status.
    Enum: 0, 1

  - `acl-suspend-acct` (integer)
    Whether to allow the reseller to suspend or unsuspend accounts.
    Enum: 0, 1

  - `acl-thirdparty` (integer)
    Whether to allow the reseller to manage third-party services.
    Enum: 0, 1

  - `acl-track-email` (integer)
    Whether to allow the reseller to view reports about email message delivery attempts from their account.
    Enum: 0, 1

  - `acl-upgrade-account` (integer)
    Whether to allow the reseller to upgrade or downgrade accounts.
    Enum: 0, 1

  - `acl-viewglobalpackages` (integer)
    Whether to allow the reseller to use all global packages. For more information, read our reseller packages documentation.
    Enum: 0, 1

## Response 200 fields (application/json):

  - `metadata` (object)

  - `metadata.command` (string)
    The method name called.
    Example: "saveacllist"

  - `metadata.reason` (string)
    The reason the API function failed when the metadata.result field is 0. This field may display a success message when a function succeeds.
    Example: "ACL List my_acl_list saved."

  - `metadata.result` (integer)
    * 1 - Success
* 0 - Failed: Check the reason field for more details.
    Enum: 0, 1

  - `metadata.version` (integer)
    The version of the API function.
    Example: 1