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)

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

HTTP/1.1 201 Created
true