> ## Documentation Index
> Fetch the complete documentation index at: https://cometchat-22654f5b-docs-agent-native-development.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Configure conversation behavior — control which message types appear as the last message and increment unread counts.

The **Settings** API lets you customize how conversations behave in your CometChat app. You can control which message types appear as the last message in a conversation and which ones increment the unread message count.

### Endpoints

| Method | Endpoint | Description |
| - | - | - |
| GET | [`/apps/{appId}/settings`](/rest-api/management-apis/settings/list-settings) | List all settings for the app |
| POST | [`/apps/{appId}/settings`](/rest-api/management-apis/settings/maps-settings) | Map (update) settings for the app |
| DELETE | [`/apps/{appId}/settings`](/rest-api/management-apis/settings/unmaps-settings) | Unmap (reset) settings for the app |

### Available settings

| Key | Description | Default |
| - | - | - |
| `core.conversations.updateOnGroupActions` | Whether group actions (member joined, left, banned) appear as the last message and increment unread count. | `true` |
| `core.conversations.updateOnReplies` | Whether thread replies appear as the last message. Thread replies do **not** increment the unread count. | `true` |
| `core.conversations.updateOnMessageActions` | Whether message actions (edited, deleted) appear as the last message and increment unread count. | `false` |
| `core.conversations.updateOnCallActivity` | Whether call activities (initiated, accepted, rejected) appear as the last message and increment unread count. | `false` |
| `core.threads.updateOnMessageActions` | Whether thread message actions (edited, deleted) appear as the last message and increment unread count. | `false` |
| `core.notifications.push.enabled` | Whether Enhanced Push Notifications are enabled for the app. | `false` |

### How settings connect to other resources

* **Conversations** — These settings directly control how [Conversations](/rest-api/conversations) display the last message and calculate unread counts.
* **Messages** — Settings determine which [Message](/rest-api/messages) types affect conversation previews.
* **Management APIs** — Use the [Map Settings API](/rest-api/management-apis/settings/maps-settings) to toggle these features.

## Error Handling

| Error Code | Description |
| - | - |
| `AUTH_ERR_EMPTY_APIKEY` | The `apikey` header is missing from the request |
| `AUTH_ERR_APIKEY_NOT_FOUND` | The provided API key is invalid |
| `AUTH_ERR_NO_ACCESS` | The API key doesn't have the required scope |

For the complete error reference, see [Error Guide](/articles/error-guide).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.