Skip to content

support_message_update

Edit the body of a message you posted yourself.

Tool

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.

When to use

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

Example

Ask your agent something like this:

Edit the body of a message you posted yourself.

The agent will invoke support_message_update with these arguments:

{
  "id": "<id>",
  "body": "<body>"
}

Esc

Start typing to search the docs.

↑↓navigate↵select