---
title: "Action chatroom_update"
description: "Updates the operator chat room user status and resets the internal status to new."
---

# Action `chatroom_update`

> **System ID:** `action_chatroom_update`

## Description

Finds the chat room by ID, sets `status_name` and the internal status `new`, then saves the changes. Both parameters support placeholders.

## Events (scenario branches)

| Event | When it occurs |
|-------|----------------|
| **success** | Chat room status updated |
| **error** | Parameters missing, room not found, or save failed |

## Parameters

| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| `chat_room_id` | string | yes | — | Chat room ID (placeholders) |
| `status_name` | string | yes | — | New user status (placeholders) |

## Configuration example

```json
{
  "chat_room_id": "{{chat_room_id}}",
  "status_name": "awaiting_review"
}
```

## Related docs

- [Actions reference](/en/actionjail/reference/actions-reference.md)