# Update cPanel account service proxying

This function lets you configure a cPanel account's
service proxying.



* If the cPanel account is a distributed account,
and you call this function on the account’s parent node,
the system will propagate the new service proxying to the child node.
* If the Web Server role is active
on the server, this function rebuilds the user's web virtual hosts (vhosts) and restarts
the web server.
* If the system cannot rebuild the user's vhosts, the API call will still succeed. However,
the function returns a failure warning in the metadata.
* To remove an account's service proxying, use the WHM API 1 
function.

Endpoint: GET /set_service_proxy_backends
Version: 11.134.0.5
Security: BasicAuth

## Query parameters:

  - `username` (string, required)
    The cPanel account's username.
    Example: "example"

  - `general` (any)
    The hostname or IP address to assign as the server that handles
the account's service proxy requests.

This parameter defaults to the existing service proxy configuration,
if one exists.

  - `service_group` (string)
    The name of a service group for which to assign a proxy backend. The
corresponding  value will be the service group's
new proxy backend.

*  — The Mail service group.

This parameter defaults to the existing setting, if one exists.



 * When you call this parameter, you  include a corresponding
  value.
 * To add  values, increment the parameter name. For example,
 , , and .
    Enum: "Mail"

  - `service_group_backend` (any)
    The hostname or IP address of the server to assign as the corresponding
 value's proxy backend server.

This parameter defaults to the existing setting, if one exists.



 * When you call this parameter, you  include a corresponding 
 value.
 * To add multiple  values, increment the parameter name.
 For example, , ,
 and .

## Response 200 fields (application/json):

  - `metadata` (object)

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

  - `metadata.reason` (string)
    The reason the API function failed when the  field is . This field may display a success message when a function succeeds.
    Example: "OK"

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

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