Removing Email Autocomplete Suggestions in FogBugz

Overview

Sometimes, outdated or improperly formatted email addresses appear in the FogBugz autocomplete dropdown when composing emails. These entries can include multiple addresses or incorrect formatting and may confuse support agents or result in misdirected communication.

To remove these suggestions without impacting cases, projects, or other user data, FogBugz provides an API command that allows administrators to delete specific email suggestions directly.

Prerequisites

Before attempting to remove email autocomplete suggestions, ensure the following:

• You have Administrator access to the FogBugz instance.

• You know the exact autocomplete string to be removed (as seen in the dropdown).

Solution

To remove outdated autocomplete suggestions for email addresses in FogBugz without affecting cases, projects, or other data, follow these steps:

1. Acquire an API Token

• Log in to your FogBugz instance with an administrator account. and generate an API token if none are available.

• 2. Use the deleteEmailAddress API Command

• FogBugz provides an XML API to manage email correspondents. Use the deleteEmailAddress command to target outdated suggestions.

API Format:

https://<your-instance>.fogbugz.com/api.asp?cmd=deleteEmailAddress&token=<your-token>&sEmail=<encoded-email>

Replace:

• <your-instance> → XXXXXXXX.fogbugz.com

• <your-token> → Your API token from Step 1

• <encoded-email> → The exact URL-encoded string from the autocomplete dropdown (e.g, <test@testirono.com> → test%40testirono.com)

3. Check the API Response

• If the API call is successful, the response will include:

  rows_affected="1"

• If the suggestion was not found or has already been removed:

  rows_affected="0"
  

In the latter case, double-check that your sEmail parameter matches the autocomplete string exactly and is correctly URL-encoded.

4. Repeat for Each Outdated Suggestion

• This process must be repeated for every suggestion you want to remove.

• There is no batch removal capability via this endpoint.