support_message_delete

Tool

support_message_delete

Delete a message you posted yourself.

Delete a message you posted yourself. The message stays in the thread as a placeholder: its body becomes empty, it carries no attachments, deletedAt is set and its edit history is destroyed. Nothing is removed without a trace. Deleting an already deleted message succeeds again and changes nothing. Deleting a public message recomputes the thread last reply timestamp from the messages left; the thread status does not change. A message posted by someone else is refused as forbidden — an admin uses support_message_delete_any. A message belonging to another product is reported as not found

Behavior

HTTP: DELETE /support/messages/:id

Arguments

Name	Type	Required	Description
id	string	•	Message id

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

Delete a message you posted yourself.

When to use

Example

Ask your agent something like this:

Delete a message you posted yourself.

The agent will invoke support_message_delete with these arguments:

{
  "id": "<id>"
}