---
title: "Change document root for cPanel account primary domain"
method: GET
path: "/set_primary_domain_docroot"
tags: ["Account Management"]
---

# Change document root for cPanel account primary domain

`GET /set_primary_domain_docroot`

This function changes the document root for a cPanel account's primary domain.

To change the document root for an addon domain or subdomain, use the cPanel
UAPI `SubDomain::changedocroot` function instead.

**Important:**

- The target directory must already exist before you call this function.
  The API function does not create it.
- This function does **not** move any files. You must ensure that the files
  exist in the new path when you call this function.
- Any parked domains (`ServerAlias` entries) on the affected domain will
  inherit the new document root.
- AutoSSL HTTP-01 renewals will fail if the new document root is empty
  or missing at renewal time.
- To revert a document root change, call this function again with the
  original path.

## Query parameters

- `docroot` string, path, required
- `username` string, username, required

## Response `200`

HTTP Request was successful.

- object
  - `data` object
    - `documentroot` string — The absolute path of the new document root.
  - `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)