# ImapSettings

- [JSON representation](https://developers.google.com/workspace/gmail/api/reference/rest/v1/ImapSettings#SCHEMA_REPRESENTATION)
- [ExpungeBehavior](https://developers.google.com/workspace/gmail/api/reference/rest/v1/ImapSettings#ExpungeBehavior)

IMAP settings for an account.

| JSON representation |
|---|
| ``` { "enabled": boolean, "autoExpunge": boolean, "expungeBehavior": enum (`https://developers.google.com/workspace/gmail/api/reference/rest/v1/ImapSettings#ExpungeBehavior`), "maxFolderSize": integer } ``` |

| Fields ||
|---|---|
| `enabled` | `boolean` Whether IMAP is enabled for the account. |
| `autoExpunge` | `boolean` If this value is true, Gmail will immediately expunge a message when it is marked as deleted in IMAP. Otherwise, Gmail will wait for an update from the client before expunging messages marked as deleted. |
| `expungeBehavior` | ``enum (`https://developers.google.com/workspace/gmail/api/reference/rest/v1/ImapSettings#ExpungeBehavior`)`` The action that will be executed on a message when it is marked as deleted and expunged from the last visible IMAP folder. |
| `maxFolderSize` | `integer` An optional limit on the number of messages that an IMAP folder may contain. Legal values are 0, 1000, 2000, 5000 or 10000. A value of zero is interpreted to mean that there is no limit. |

## ExpungeBehavior

| Enums ||
|---|---|
| `expungeBehaviorUnspecified` | Unspecified behavior. |
| `archive` | Archive messages marked as deleted. |
| `trash` | Move messages marked as deleted to the trash. |
| `deleteForever` | Immediately and permanently delete messages marked as deleted. The expunged messages cannot be recovered. |