OpenIMSDKDocs

Type at least two characters to search titles and routes.

EN

Language

ENEnglishEnglish docs简中简体中文中文文档
Browse SDKs · iOS
Platform
SDKsiOS

Clear all messages

Clear all local and server-side messages for the current account with OpenIM iOS SDK.

Copy

Invoke deleteAllMsgFromLocalAndSvrWithOnSuccess:onFailure: on OIMManager to permanently clear all conversation history stored locally and on the server for the current account:

Parameters

ParameterTypeRequiredDescription
onSuccessOIMSuccessCallbackYesSuccess callback confirming message history was cleared across local and server storage.
onFailureOIMFailureCallbackYesFailure callback returning error code code and descriptive message msg.

Code example

[[OIMManager manager] deleteAllMsgFromLocalAndSvrWithOnSuccess:^(NSString * _Nullable data) {
    // Clear completed; reset local message caches and refresh conversation views
    [self resetAllMessageSnapshots];
} onFailure:^(NSInteger code, NSString * _Nullable msg) {
    // Handle clearing failure
}];

Return value

The onSuccess callback confirms that all local and server-side message records for the current account were deleted.

State changes after the call

  1. Irreversible account-level operation: This operation clears message records for the current logged-in account across both local SQLite storage and remote server storage. It does not delete copies stored on other conversation members' devices.
  2. Conversation summary synchronization: After clearing messages, update the in-memory cache and UI views. Conversation summaries and latest message previews will reflect these changes through conversation change events or subsequent conversation list queries. To clear local device storage only without touching server records, see Clear all local messages.