Edit

[POST] .../v1/chatmessage/edit

Edits chat message. Use this method to change the text, mentions or file list of an existing editable chat message. The request body is required and id must contain the message UUID; if text is supplied without mentions, the server clears the previous mention list. Access is scoped to the current request user's message edit rights in the chat or linked entity workflow and the response returns row_affected. Missing body, missing id, missing message, denied access, invalid files, closed chat restrictions, mention processing errors and database failures are returned as HTTP 200 ErrorResult business errors.

Request Parameters

Name Type Required Description
file_ids Array of Int64 Optional New file list.
id String Required Message UUID.
mention_options CommonMentionOptions Optional Mention processing options.
mentions Array of CommonMentionInput Optional New list of structured mentions in text. If text is passed but mentions is omitted, the server clears previous mentions.
text String Optional New message text.

Request Example

{
  "id": "4b9727ec-a389-4274-95b6-069350000001",
  "text": "Please review the updated supplier invoice.",
  "file_ids": [
    321
  ]
}

Response Parameters

Name Type Description
ok Boolean Indicates whether the request completed successfully.
result Update Update operation result.

Response Example

{
  "ok": true,
  "result": {
    "row_affected": 1
  }
}