---
title: "Update Shared Message"
method: PUT
path: "/api/v1/monitor/messages/shared/{message_id}"
tags: ["Monitor"]
---

# Update Shared Message

`PUT /api/v1/monitor/messages/shared/{message_id}`

Update a message on a shared/public flow, scoped to the authenticated user.

## Path parameters

- `message_id` string, uuid, required

## Query parameters

- `source_flow_id` string, uuid, required — The original public flow ID

## Request body

- MessageUpdate
  - `category` string, nullable
  - `content_blocks` object[], nullable
  - `context_id` string, nullable
  - `edit` boolean, nullable
  - `error` boolean, nullable
  - `files` string[], nullable
  - `properties` Properties
    - `allow_markdown` boolean
    - `background_color` string, nullable
    - `build_duration` number, nullable
    - `edited` boolean
    - `icon` string, nullable
    - `positive_feedback` boolean, nullable
    - `source` Source
      - `display_name` string, nullable — The display name of the source component.
      - `id` string, nullable — The id of the source component.
      - `source` string, nullable — The source of the message. Normally used to display the model name (e.g. 'gpt-4o')
    - `state` 'partial' | 'complete'
    - `targets` unknown[]
      - unknown
    - `text_color` string, nullable
    - `usage` Usage — Token usage information from LLM responses.
      - `input_tokens` integer, nullable
      - `output_tokens` integer, nullable
      - `total_tokens` integer, nullable
  - `sender` string, nullable
  - `sender_name` string, nullable
  - `session_id` string, nullable
  - `session_metadata` object, nullable
  - `text` string, nullable

## Response `200`

Successful Response

- MessageRead
  - `category` string
  - `content_blocks` object[]
  - `context_id` string, nullable
  - `edit` boolean
  - `error` boolean
  - `files` string[]
  - `flow_id` string, uuid, nullable
  - `id` string, uuid, required
  - `properties` Properties
    - `allow_markdown` boolean
    - `background_color` string, nullable
    - `build_duration` number, nullable
    - `edited` boolean
    - `icon` string, nullable
    - `positive_feedback` boolean, nullable
    - `source` Source
      - `display_name` string, nullable — The display name of the source component.
      - `id` string, nullable — The id of the source component.
      - `source` string, nullable — The source of the message. Normally used to display the model name (e.g. 'gpt-4o')
    - `state` 'partial' | 'complete'
    - `targets` unknown[]
      - unknown
    - `text_color` string, nullable
    - `usage` Usage — Token usage information from LLM responses.
      - `input_tokens` integer, nullable
      - `output_tokens` integer, nullable
      - `total_tokens` integer, nullable
  - `run_id` string, uuid, nullable
  - `sender` string, required
  - `sender_name` string, required
  - `session_id` string, required
  - `session_metadata` object, nullable
  - `text` string, required
  - `timestamp` string, date-time

## Other responses

- `422` — Validation Error

## Changes

- **2026-07-21** `22962dc5e81b` — 2 breaking, 6 warning
  - removed the required property `content_blocks/items/contents` from the response with the `200` status
  - removed the required property `content_blocks/items/title` from the response with the `200` status
  - removed the request property `content_blocks/anyOf[subschema #1]/items/allow_markdown`
  - removed the request property `content_blocks/anyOf[subschema #1]/items/contents`
  - …4 more
- **2026-06-08** `a5c4fa6a88f7` — 1 breaking, 3 info
  - the response property `flow_id` became optional for the status `200`
  - added the new optional request property `category`
  - added the new optional request property `content_blocks`
  - added the optional property `run_id` to the response with the `200` status
- **2026-04-13** `acd160326a88` — 1 info
  - endpoint added
- **2025-10-16** `9bd3e81318d7` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/langflow-ai/apis/langflow/changes/api/v1/monitor/messages/shared/:message_id/put.md)

---

[API](https://skmtc.dev/langflow-ai/apis/langflow.md) · [All operations](https://skmtc.dev/langflow-ai/apis/langflow/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/langflow-ai/langflow/revisions/22962dc5e81b/schema)