---
title: "Set Message Ui State"
method: POST
path: "/api/chats/{chat_id}/messages/{message_id}/ui-state"
tags: ["chats"]
---

# Set Message Ui State

`POST /api/chats/{chat_id}/messages/{message_id}/ui-state`

## Request

- Base URL: `https://app.thinqos.com` (the document declares no server; this is the origin it was published from)
- URL: `https://app.thinqos.com/api/chats/{chat_id}/messages/{message_id}/ui-state`
- Auth: none declared

Tick or untick an interactive checklist item on a panel, for everyone.

Any active participant may, the same people who may react to the message.
The state is stored on the panel message and every other viewer is told to
reload, so a room sees one shared checklist.

## Path parameters

- `chat_id` string, uuid, required
- `message_id` string, uuid, required

## Headers

- `x-impersonate-identity-id` string, nullable

## Request body

- UiStateRequest: TOS-2341 Phase 3: tick or untick one interactive checklist item.
  - `item_id` string, required
  - `checked` boolean, required

## Response `200`

Successful Response

- UiStateEntry: One interactive checklist item's shared state (TOS-2341 Phase 3).
  - `checked` boolean, required
  - `by` string, uuid, nullable
  - `by_name` string, required
  - `at` string, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/thinqos/apis/thinqos-api.md) · [All operations](https://skmtc.dev/thinqos/apis/thinqos-api/llms.txt) · [OpenAPI document](https://skmtc.dev/thinqos/apis/thinqos-api/revisions/ce2c2ce318b1?raw)