Edit sent messages

ctx.reply() returns a ReplyHandle so that you can edit the message you just sent on the provider. This is useful when you post “Processing…” and replace it with the final text. That is not a reply type; it updates a message you already sent.

Channel support

Capability	Slack	Teams	WhatsApp	Telegram	Email
Message edits in place	Yes	Yes	Yes	Yes	No
Plan card via edit-in-place	Native plan card	Markdown edit-in-place	No	Markdown edit-in-place	No
Outbound file attachments on edit	Yes	Yes	Not yet	Not yet	Not yet

See Channels overview for the full matrix.

Basic edit

The following example sends a placeholder message, does work, then updates the same message in place:

const sentMessage = await ctx.reply('Processing...');
// ... do some work ...
await sentMessage.edit('Done! Here are your results.');

Edit with attachments

You can attach files when editing plain text or markdown content. Outbound files are delivered on Slack and Microsoft Teams; other channels do not support them yet. See Sending attachments.

await sentMessage.edit('Updated report attached.', {
 files: [{ filename: 'report.pdf', url: 'https://example.com/report.pdf' }],
});

Edits update the existing platform message rather than posting a new one. Not every provider supports message editing. See Channels overview and the Channel support strip above.

Reply

Send plain text, markdown, attachments, and interactive cards.

Handlers and context

Event handlers and the context object your agent receives on every turn.

⌘I

Getting Started

Channels

Custom Code Agent

Managed Agent

Observability

Edit sent messages

Channel support

Basic edit

Edit with attachments

Reply

Handlers and context

​Channel support

​Basic edit

​Edit with attachments

​Related

Reply

Handlers and context

Channel support

Basic edit

Edit with attachments

Related