---
title: Moderator Role API
updatedAt: 2026-04-02T15:35:49.000Z
---

Fetch the complete documentation index at: https://docs.watchers.io/llms.txt

# Moderator Role API

This guide explains how to assign a moderator role to a user in a specific chat room using backend-to-backend communication.

**Endpoint**

```
https://chatbackend.watchers.io/user/external/moder

> ⚠️ **Regional endpoints:** Replace `chatbackend.watchers.io` with the endpoint matching your project region. See [Supported Regions](https://docs.watchers.io/docs/supported-regions) for details.
> | Region | Endpoint |
> | :--- | :--- |
> | Europe (default) | `chatbackend.watchers.io` |
> | North America | `chatbackend.us.watchers.io` |
> | South America | `chatbackend.sa.watchers.io` |
> | Asia | `chatbackend.hk.watchers.io` |
> | Africa | `chatbackend.za.watchers.io` |
```

## Request Parameters

| Parameter       | Description                      |
| --------------- | -------------------------------- |
| decryptedUserId | The unencrypted ID of the user   |
| roomId          | The ID of the existing chat room |

## Required Headers

| Parameter     | Description                                                                                                                 |
| ------------- | --------------------------------------------------------------------------------------------------------------------------- |
| x-api-key     | Your public API key used for the project                                                                                    |
| Authorization | Bearer token what you can get from the back office (*Admin panel / Settings / Bearer tokens*) for back-to-back integrations |

## Example Request (cURL)

```jsx
curl --location 'https://chatbackend.watchers.io/user/external/moder' \
--header 'x-api-key: {API KEY}' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {TOKEN}' \
--data '{
  "decryptedUserId": "{unencrypted user id}",
  "roomId": "{existing room id}"
}'
```

## Example Success Response

```json
HTTP/1.1 201 Created
true
```