# Subdomains

The SubDomain module for cPanel UAPI.

## Change a subdomain or addon domain document root

 - [GET /SubDomain/changedocroot](https://api.docs.cpanel.net/specifications/cpanel.openapi/subdomains/changedocroot.md): This function changes the document root for a subdomain or addon domain
that the calling cPanel user owns.

Important:

- This function does not apply to the account's primary domain.
  Use the WHM API set_primary_domain_docroot function to change the document root for a primary domain.
- The target directory must already exist before you call this function.
  The 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.

When you disable the Web Server role,
the system disables this function.