# Spam Management

Email / Spam Management

## Update minimum spam score threshold value

 - [GET /Email/add_spam_filter](https://api.docs.cpanel.net/specifications/cpanel.openapi/spam-management/email-add_spam_filter.md): This function sets a new minimum Apache SpamAssassin™ spam score threshold value.

Notes:

  * To disable spam filtering, use the UAPI Email::disable_spam_autodelete fuction.
  * For more information, read our Spam Filters documentation.

Important:

   When you disable the Spam Filter* role, the system disables this function.

## Disable Apache SpamAssassin for cPanel account

 - [GET /Email/disable_spam_assassin](https://api.docs.cpanel.net/specifications/cpanel.openapi/spam-management/email-disable_spam_assassin.md): This function disables Apache SpamAssassin™ for a cPanel account.

Important:

  When you disable the Spam Filter role, the system disables this function.

## Disable spam box filtering auto-delete

 - [GET /Email/disable_spam_autodelete](https://api.docs.cpanel.net/specifications/cpanel.openapi/spam-management/email-disable_spam_autodelete.md): This function disables the Apache SpamAssassin™ auto-delete spam feature.

Important:

  When you disable the Receive Mail role, the system disables this function.

## Disable spam box filtering for cPanel account

 - [GET /Email/disable_spam_box](https://api.docs.cpanel.net/specifications/cpanel.openapi/spam-management/email-disable_spam_box.md): This function disables spam box filtering for a cPanel account. When you disable spam box filtering, the system sends all messages to the account's inbox.

Notes:

  * This function requires that your hosting provider enables Apache SpamAssassin™ on the server.
  * To enable spam box filtering, use the UAPI Email::enable_spam_box function.
  * For more information, read our Spam Filters documentation.

Important:

  When you disable the Spam Filter role, the system disables this function.

## Enable Apache SpamAssassin for cPanel account

 - [GET /Email/enable_spam_assassin](https://api.docs.cpanel.net/specifications/cpanel.openapi/spam-management/email-enable_spam_assassin.md): This function enables Apache SpamAssassin™ for the account.

Important:

When you disable the Spam Filter role, the system disables this function.

## Enable spam box filtering for cPanel account

 - [GET /Email/enable_spam_box](https://api.docs.cpanel.net/specifications/cpanel.openapi/spam-management/email-enable_spam_box.md): This function enables spam box filtering for a cPanel account. When you enable spam box filtering, the system sends messages marked as spam to a spam folder.

Notes:

* This function requires that your hosting provider enables Apache SpamAssassin on the server.
* To disable spam box filtering, use the UAPI Email::disable_spam_box function.
* For more information, read our Spam Filters documentation.

Important:

When you disable the Spam Filter role, the system disables this function.

## Return email account Apache SpamAssassin settings

 - [GET /Email/get_spam_settings](https://api.docs.cpanel.net/specifications/cpanel.openapi/spam-management/email-get_spam_settings.md): This function retrieves the Apache SpamAssassin™ settings for the account.

Important:

When you disable the SpamFilter role, the system disables this function.

## Delete spam box contents

 - [GET /SpamAssassin/clear_spam_box](https://api.docs.cpanel.net/specifications/cpanel.openapi/spam-management/spamassassin-clear_spam_box.md): This function clears the spam box of all its contents for all email accounts.

Important:

This function deletes the Spam Box folder contents for every email address on the account, which includes the system user email account.

## Return SpamAssassin™ symbolic test scores

 - [GET /SpamAssassin/get_symbolic_test_names](https://api.docs.cpanel.net/specifications/cpanel.openapi/spam-management/spamassassin-get_symbolic_test_names.md): This function lists the Apache SpamAssassin™ scores for each symbolic test.

## Return SpamAssassin™ settings

 - [GET /SpamAssassin/get_user_preferences](https://api.docs.cpanel.net/specifications/cpanel.openapi/spam-management/spamassassin-get_user_preferences.md): This function lists the Apache SpamAssassin™ settings for the account.

Note:

Additional customizations may appear in the returns. Form more information read the Apache SpamAssassin™ configuration file documentation.

## Update SpamAssassin™ settings

 - [GET /SpamAssassin/update_user_preference](https://api.docs.cpanel.net/specifications/cpanel.openapi/spam-management/spamassassin-update_user_preference.md): This function sets the Apache SpamAssassin™ settings for the account.

Note:

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