support_message_update
Edit the body of a message you posted yourself.
Edit the body of a message you posted yourself. Only the identity that created the message may edit it; a message posted by someone else, from the public edge or before authorship was recorded is refused as forbidden. The previous body is kept as a revision and editedAt is set. A deleted message cannot be edited (conflict). Sending the same body changes nothing. An edit does not move the thread's last reply timestamp. A message belonging to another product is reported as not found
Behavior
- HTTP
PATCH /support/messages/:id
Arguments
Name | Type | Required | Description |
|---|---|---|---|
id | string | • | Id of the message to edit |
body | string | • | The new message text, stored verbatim. It replaces the whole body. An empty string is accepted only on a message that carries at least one attachment — a picture may stand alone, a message with nothing to show may not |
Response
Field | Type | Always | Description |
|---|---|---|---|
id | string | • | Message id |
body | string | • | The message text, byte-identical to what was stored |
editedAt | string | • | ISO-8601 time of the last edit, or null when the message was never edited |
threadId | string | • | Thread this message belongs to |
createdAt | string | • | ISO-8601 creation timestamp |
deletedAt | string | • | ISO-8601 time the message was deleted, or null. A deleted message stays in the thread as a placeholder: its body is empty and it carries no attachments |
direction | string | • | inbound: written by the external end user. outbound: written by support, going out to them |
visibility | string | • | public: part of the conversation the external end user sees. internal: a note between agents that never leaves the support contour |
attachments | array | • | Files this message carries, each with a freshly signed download URL. Empty when there are none. Attachments whose upload was never confirmed are never listed here |
attachmentIds | array | • | The same files as a flat list of ids, in the order attachments[] has them. This is the value support_message_create takes back; attachments.0.id names only the first file |
authorAgentId | string | • | The agent author, or null when the external end user wrote the message |
attachmentCount | integer | • | How many files this message carries, 0 when it carries none. A dot-path has no length, so this is the only way a step can branch on whether there are files at all — and a message may carry a file and no body, so it is what tells those two messages apart |
authorExternalId | string | • | The external author, or null when an agent wrote the message |
createdByIdentityId | string | • | The Lepsto identity that posted the message — the one allowed to edit or delete it. Null for a message from the public edge or from before authorship was recorded: nobody owns those, and only support_message_delete_any removes them |
Try it
Edit the body of a message you posted yourself.