> ## Documentation Index
> Fetch the complete documentation index at: https://www.cometchat.com/docs/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).