# Update SpamAssassin™ settings

This function sets the Apache SpamAssassin™ settings for the account.



Additional customizations may appear in the function's return. For more information,
read the Apache SpamAssassin configuration file documentation.

Endpoint: GET /SpamAssassin/update_user_preference
Version: 11.134.0.5
Security: BasicAuth

## Query parameters:

  - `preference` (string, required)
    The variable that you want to manipulate.

* 
* 
* 
* 
* A custom SpamAssassin variable.



* You can  choose one of these possible values per call.
* If you enter a value for the  parameter, but you do  define a value for the  parameter, the function will remove any previous settings.
    Example: "score"

  - `value` (string)
    The value for the preference of the variable that you want to manipulate.

* A valid SpamAssassin "" value when the value of the  parameter is , where:

    *  represents the symbolic name of the test. For list of symbolic test names, run the UAPI  function.
    *  represents the floating-point value that SpamAssassin assigns to the mail when the test result is true. The score value must be greater than , and less than .

* A valid floating-point number if the value of the  parameter is .
* A valid email address if the value of the  parameter is  or .
* A custom SpamAssassin variable value.



To enter multiple values, increment the parameter name. For example, use the  and  parameters.
    Example: "ACT_NOW_CAPS 5.0"

## Response 200 fields (application/json):

  - `apiversion` (integer)
    The version of the API.
    Example: 3

  - `func` (string)
    The name of the method called.
    Example: "update_user_preference"

  - `module` (string)
    The name of the module called.
    Example: "SpamAssassin"

  - `result` (object)

  - `result.data` (object)
    Example: {"blacklist_from":["username2@example.com"],"ok_locales":["all"],"required_score":[5],"score":["ACT_NOW_CAPS 5"],"whitelist_from":["username@example.com"]}

  - `result.data.additionalProperties` (array)
    An array containing custom SpamAssassin variable values.



The array's name is the custom SpamAssassin variable's name.
    Example: ["mycustomscore"]

  - `result.data.blacklist_from` (array)
    An array of email addresses on the blacklist.
    Example: ["username2@example.com"]

  - `result.data.required_score` (array)
    An array containing the score at which the system will mark a message as spam. The system considers mail that matches this score to be spam.
    Example: [5]

  - `result.data.score` (array)
    An array of the symbolic test names and their scores.
    Example: ["ACT_NOW_CAPS 5"]

  - `result.data.whitelist_from` (array)
    An array of the email addresses on the whitelist.
    Example: ["username@example.com"]

  - `result.errors` (array,null)
    List of errors if the API failed.

  - `result.messages` (array,null)
    List of messages generated by the API.

  - `result.metadata` (object)

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

  - `result.warnings` (array,null)
    List of warnings generated by the API. Warnings describe non-critical failures or other problematic conditions noted while running an API.