apidocs

SetEmailAndNotificationSettings API

Updates the email and notification settings for the infoRouter system. Requires system administrator privileges.

Endpoint

/srv.asmx/SetEmailAndNotificationSettings

Methods

• GET /srv.asmx/SetEmailAndNotificationSettings?authenticationTicket=...&settingsXml=...
• POST /srv.asmx/SetEmailAndNotificationSettings (form data)
• SOAP Action: http://tempuri.org/SetEmailAndNotificationSettings

Parameters

Parameter	Type	Required	Description
authenticationTicket	string	Yes	Authentication ticket obtained from AuthenticateUser
settingsXml	string	Yes	XML-serialized EmailAndNotificationSettings object

settingsXml Structure

Use GetEmailAndNotificationSettings to retrieve the current settings and use that XML as the input template. All fields must be present.

<EmailAndNotificationSettings>
  <FaxQue>c:\faxque</FaxQue>
  <TruncateLongEmailFields>false</TruncateLongEmailFields>
  <AllowEmailAttachments>true</AllowEmailAttachments>
  <AttachmentSizeLimit>5242880</AttachmentSizeLimit>
  <SubscriptionNotifications>true</SubscriptionNotifications>
  <AllowPartialEmailUploads>false</AllowPartialEmailUploads>
  <SendToSendEmail>true</SendToSendEmail>
  <SendToAllowSendEmailAttachments>true</SendToAllowSendEmailAttachments>
  <SendToDisplayUserList>true</SendToDisplayUserList>
  <SendToSendEmailsFromUsersEmail>false</SendToSendEmailsFromUsersEmail>
  <SendToLogCcAddress></SendToLogCcAddress>
  <SendNotificationsOnDragDrop>false</SendNotificationsOnDragDrop>
  <TimeZoneSettingsNotifications>UseGMT</TimeZoneSettingsNotifications>
</EmailAndNotificationSettings>

Response

Success Response

<root success="true" />

Error Response

<root success="false" error="[ErrorCode] Error message" />

Fields

Subscription Notifications

| Field | Type | Description | |——-|——|————-| | SubscriptionNotifications | bool | Enable email notifications for document/folder subscriptions | | SendNotificationsOnDragDrop | bool | Send notifications when documents are moved via drag-and-drop | | TimeZoneSettingsNotifications | string | Timezone for notification timestamps: UseGMT or UseServerLocal |

Email Attachments (inbound)

| Field | Type | Description | |——-|——|————-| | AllowEmailAttachments | bool | Allow documents to be attached to outgoing emails | | AttachmentSizeLimit | long | Maximum attachment size in bytes (e.g., 5242880 = 5 MB) | | AllowPartialEmailUploads | bool | Allow email documents to be uploaded even if some parts are missing | | TruncateLongEmailFields | bool | Truncate oversized email header fields on import |

Send To (outbound email)

| Field | Type | Description | |——-|——|————-| | SendToSendEmail | bool | Enable the Send To Email feature | | SendToAllowSendEmailAttachments | bool | Allow document attachments in Send To emails | | SendToDisplayUserList | bool | Show a user list picker in the Send To Email dialog | | SendToSendEmailsFromUsersEmail | bool | Use the logged-in user’s email address as the From address | | SendToLogCcAddress | string | CC address for all outbound Send To emails (audit/log copy) |

Required Permissions

Caller must be a system administrator with UpdateApplicationSettingsAndPolicies permission.

Example

Request (POST)

POST /srv.asmx/SetEmailAndNotificationSettings HTTP/1.1
Content-Type: application/x-www-form-urlencoded

authenticationTicket=abc123&settingsXml=<EmailAndNotificationSettings>...</EmailAndNotificationSettings>

Notes

• The recommended workflow is: call GetEmailAndNotificationSettings, modify the returned XML, then pass it to SetEmailAndNotificationSettings.
• SMTP server connection settings (server, port, username, password) are managed in appsettings.json and cannot be changed through this API.
• AttachmentSizeLimit must be provided in bytes; the UI displays this value in KB.
• FaxQue is accepted in the XML but only persisted if it differs from the default value (c:\faxque).
• Settings take effect immediately; the in-memory cache is invalidated on a successful update.