---
title: "Restrict Access to WHM by CIDR list."
method: GET
path: "/restrict_whm_root_access"
tags: ["WHM Access"]
---

# Restrict Access to WHM by CIDR list.

`GET /restrict_whm_root_access`

This function restricts root login to cPanel & WHM based on a list of CIDR addresses.

**Note:**

This API manipulates `/var/cpanel/authorized_whm_root_ips`. We HIGHLY recommend
you not modify this file directly. Improper formatting of the file can lead to loss of all
access to cPanel & WHM using the root password.

Use of this API replaces any previous restrictions so be sure to include previous CIDR patterns
when adding new ones.

As this API only restricts logins, please be aware that existing root logins are not terminated
when these restrictions are asserted.

This API DOES NOT restrict root resellers.

## Query parameters

- `cidr` string, cidr, required

## Response `200`

HTTP Request was successful.

- object
  - `data` object
    - `cidr` string[] — A reduced list of what CIDR addresses root access will be restricted to.
  - `metadata` object
    - `command` string — The method name called.
    - `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.
    - `result` 0 | 1 — * `1` - Success. * `0` - Failed. Check the reason field for more details.
    - `version` integer — The version of the API function.

---

[API](https://skmtc.net/cpanel/apis/whm-api.md) · [All operations](https://skmtc.net/cpanel/apis/whm-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cpanel/whm-api/revisions/3da41671c02c/schema)