Skip to main content
PATCH
Update a message

Authorizations

x-api-key
string
header
required

Workspace API key. Current accepted keys use the ando_sk_ prefix.

Path Parameters

messageId
string
required

Message identifier.

Body

application/json

Edit body for a conversation message. See the operation for edit semantics.

markdown_content
string
required

Replacement message markdown content. Must contain renderable text unless app_card is sent: clearing a message body is not supported.

app_card
object

Replacement document card. The message must already carry a document card; the server validates the version-1 CardDocument and regenerates the text fallback.

URLs to send as plain links: no link preview and no app card. Omit to leave the stored list unchanged.

URL.

Response

Updated message.

Message detail response with the standard public data envelope plus legacy top-level aliases.

authorWorkspaceMembershipId
string
required

Canonical author workspace membership identifier. Matches legacy author_id during the compatibility window.

Example:

"01jzn7e61x3a7v9h2r7t2m3q4p"

author_id
string
required
deprecated

Author workspace member identifier. Deprecated: read authorWorkspaceMembershipId instead.

Example:

"01jzn7e61x3a7v9h2r7t2m3q4p"

author_name
string | null
required

Author workspace member display name.

content
string | null
required

Message markdown content.

conversation_id
string
required

Conversation identifier.

Example:

"01jzn7e61x3a7v9h2r7t2m3q4p"

conversation_name
string | null
required

Conversation name.

created_at
string<date-time>
required

Message creation timestamp.

Example:

"2026-05-14T08:00:00.000Z"

data
object
required

Public message result. thread_root_id identifies the thread a reply belongs to; replied_to_message_id is not exposed.

id
string
required

Message identifier.

Example:

"01jzn7e61x3a7v9h2r7t2m3q4p"

image_urls
string<uri>[]
required

Image URLs extracted from the message.

Image URL.

reactions
object[]
required

Emoji reaction counts on the message.

replies_count
integer
required

Number of thread replies.

Required range: x >= 0
thread_root_id
string | null

Root message identifier when this message is a thread reply; null for a top-level message. Pass it to GET /conversation-messages/{messageId}/replies to read the thread. Absent on older deployments.