Service: zimbraAccount

Command: ModifyPrefs
Namespace: urn:zimbraAccount
Description: Modify Preferences
Notes:
For multi-value prefs, just add the same attribute with 'n' different values:
      <ModifyPrefsRequest>
          <pref name="foo">value1</pref>
          <pref name="foo">value2</pref>
          .
          .
      </ModifyPrefsRequest>
 

You can also add/subtract single values to/from a multi-value pref by prefixing the preference name with a '+' or '-', respectively in the same way you do when using zmprov. For example:
      <ModifyPrefsRequest>
          <pref name="+foo">value1</pref>
          <pref name="-foo">value2</pref>
          .
          .
      </ModifyPrefsRequest>
 
Properties:
Authorization token required true
Admin Authorization token required false

ModifyPrefsRequest

    <ModifyPrefsRequest> ## ModifyPrefsRequest
        (<pref name="{pref-name}" [modified="{pref-modified-time} (Long)"]>{value}</pref> ## Pref)*
    </ModifyPrefsRequest>

elements and attributes you can define within a <ModifyPrefsRequest> element:

XPath Required / Optional Description
/pref Optional (0 or more) Type: {value}
Specify the preferences to be modified
Description for element text content:Preference value
/pref@name Required (only 1) Type: String
Preference name
/pref@modified Optional (0 or 1) Type: Long
Preference modified time (may not be present)

ModifyPrefsResponse

    <ModifyPrefsResponse /> ## ModifyPrefsResponse