Skip to main content
PUT
Update a message

Authorizations

Authorization
string
header
required

Bearer token authentication

Path Parameters

conversation_id
string
required

The conversation's uuid_v7, or its numeric id.

id
string
required

The message's uuid_v7, or its numeric id.

Body

application/json
message
object
required

Response

Success

attachments
object[]
required
body
string
required
conversation_id
integer
required
created_at
string<date-time>
required
deleted_at
string<date-time> | null
required
edited_at
string<date-time> | null
required
emoji_only_count
integer
required
id
integer
required
mentioned_recipients
object[]
required
metadata
object | null
required
pinned
boolean
required
reaction
required

Any valid JSON value for provider, integration, theme, metadata, or other dynamic payloads whose keys are not fixed by the API contract.

reaction_stats
required

Any valid JSON value for provider, integration, theme, metadata, or other dynamic payloads whose keys are not fixed by the API contract.

replied_to_message
required

Any valid JSON value for provider, integration, theme, metadata, or other dynamic payloads whose keys are not fixed by the API contract.

seen_by
object[]
required
seen_by_count
integer
required
sender_recipient
object
required
sent_at
string<date-time>
required
status
string
required
type
string
required
updated_at
string<date-time>
required
reply_count
integer

On a thread's first message, how many replies the thread has; 0 otherwise.

last_reply_at
string<date-time> | null

On a thread's first message, when its latest reply was posted.

reply_recipients
object[]

On a thread's first message, the up to three people who replied most recently.

thread_unread_count
integer

On a thread's first message, how many of its replies you follow and have not read.

also_sent_to_channel
boolean

On a thread reply, whether it was also posted to the conversation.

app
object | null

For a message an incoming webhook or an app's own Flow sender posted, the app it shows as; null for every other message.

sent_via
object | null

For a message an app sent as a person who allowed it to, the app it was sent through; null otherwise.

blocks
object[]

The bot's interactive cards on this message; empty for a person's message.

An interactive card a bot attaches to its message. A choices card asks one multiple-choice question; a person answers it by posting the option's label with in_reply_to_block, which records answered_option_id on the card. A card with allow_custom also takes a typed answer, sent as option custom with custom_value; an answered card keeps the answer's words in answered_value (D-423). A card naming an onboarding purpose carries the action Fluid applies when the bot's owner or a steward answers it. An integration card offers a connection the bot can use. A canvas card opens a page of the bot's canvas (company API companyBotCanvasPagesShow) by its slug. A chart card draws figures over time or side by side. A mist_result card shows a Mist run's result, with Mist's summary and check, before and after screenshots, and a preview.

uuid_v7
string<uuid>

The stable UUIDv7 identifier. Messaging routes accept it wherever they accept the numeric id.