Sign in
latestOpenAPI 3.0.32026-08-2142130334.7 KB

0a94056fba48

Messages

Update a message

Replaces the markdown body of a message authored by the authenticated API-key workspace membership. Each accepted edit marks the message as edited and emits a message.updated ProductEvent to webhook and realtime subscribers. Attachments, thread placement, and authorship are fixed at create time and are not editable. Sending a body identical to the stored one is a no-op: the message keeps its revision and no event is emitted. Editing does not create new mentions or notifications.

patch/conversation-messages/{messageId}

Path parameters

messageIdstring required

Message identifier.

Message identifier.

Request body

markdown_contentstring required

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

suppressed_link_preview_urlsstring[]

URLs whose link previews should be suppressed. Omit to leave the stored list unchanged.

Response

Updated message.

authorWorkspaceMembershipIdstring required

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

author_idstring required

Author workspace member identifier. Deprecated: read authorWorkspaceMembershipId instead.

author_namestring nullable required

Author workspace member display name.

contentstring nullable required

Message markdown content.

conversation_idstring required

Conversation identifier.

conversation_namestring nullable required

Conversation name.

created_atstring date-time required

Message creation timestamp.

idstring required

Message identifier.

image_urlsstring[] required

Image URLs extracted from the message.

replies_countinteger required

Number of thread replies.

Example response

{
  "authorWorkspaceMembershipId": "01jzn7e61x3a7v9h2r7t2m3q4p",
  "author_id": "01jzn7e61x3a7v9h2r7t2m3q4p",
  "conversation_id": "01jzn7e61x3a7v9h2r7t2m3q4p",
  "created_at": "2026-05-14T08:00:00.000Z",
  "data": {
    "authorWorkspaceMembershipId": "01jzn7e61x3a7v9h2r7t2m3q4p",
    "author_id": "01jzn7e61x3a7v9h2r7t2m3q4p",
    "conversation_id": "01jzn7e61x3a7v9h2r7t2m3q4p",
    "created_at": "2026-05-14T08:00:00.000Z",
    "id": "01jzn7e61x3a7v9h2r7t2m3q4p"
  },
  "id": "01jzn7e61x3a7v9h2r7t2m3q4p"
}