---
title: "Update Conversation Note"
method: PATCH
path: "/conversations/{conversation_id}/note"
tags: ["Messages"]
---

# Update Conversation Note

`PATCH /conversations/{conversation_id}/note`

Set or clear the host's private note attached to a conversation thread. The note is stored only in Hostex (visible in the Hostex Inbox), is **never** sent to the guest or pushed to any channel, and is shared across operators inside the same account. Pass an empty string or `null` in `note` to clear the existing note.

## Path parameters

- `conversation_id` string, required

## Request body

- object
  - `note` string, nullable, required — The host-side private note. Pass an empty string or `null` to clear the existing note. Max 5000 characters.

## Response `200`

- object
  - `request_id` string, required — Unique identifier for the request.
  - `error_code` integer, required — Numeric error code representing the status of the response. A value of `200` indicates success. <br> See the [Error Codes](/reference/error-manual#error-codes) section for more information.
  - `error_msg` string, required — Message detailing the status of the response.
  - `data` object, required
    - `id` string, required — The id of the conversation.
    - `note` string, nullable, required — The current note value after the update (null when cleared).
    - `updated_at` string, date-time, nullable — When the note was last updated, ISO 8601.

---

[API](https://skmtc.net/hostex/apis/hostex-api.md) · [All operations](https://skmtc.net/hostex/apis/hostex-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hostex/hostex-api/versions/a3fa555dee66/schema)