For the complete documentation index, see llms.txt. This page is also available as Markdown.

UpdateMessage

Task to update existing Slack messages with support for text content, Block Kit formatting, and link/media previews.

Task version: 2.0.0

Required Frends version: 5.7+

Required .NET version: 8.0

Compatible Agents: Crossplatform

Task Parameters

Name
Description

ChannelId : String

Channel ID where the message exists

Default: - Example: C12345678

MessageTs : String

Timestamp of the message to update

Default: - Example: 1234567890.123456

Mode : MessageMode

Message format mode

Possible values:

  • PlainText: Message format mode

  • Blocks: Message format mode

Default: - Example: PlainText

Text : String

The plain text content (when Mode = PlainText)

Default: - Example: Updated message text

Blocks : String

Block Kit JSON (when Mode = Blocks)

Default: - Example: [{ "type": "section", "text": { "type": "mrkdwn", "text": "Updated content" } }]

Name
Description

🗝Token : String

Slack OAuth token used for authentication.

If the token is a bot token (starts with "xoxb"), messages

will be updated as the Slack app's bot user.

If the token is a user token (starts with "xoxp"), messages

will be updated as the Slack user who authorized the token.

The token owner must be the original message poster

or have appropriate permissions to edit the message.

Note: User tokens require the user to have authorized the app via OAuth

with appropriate scopes (e.g., "chat:write").

Default: - Example: xoxb-123456789

Name
Description

UnfurlLinks : Boolean

Whether to expand URLs in the message into rich previews (e.g. YouTube, websites).

Note: Slack may unfurl a link only once per channel to reduce duplication.

Default: True Example: true

UnfurlMedia : Boolean

Whether to show media previews (e.g. images, video thumbnails) for links in the message.

Note: Media previews may appear only on first post of the same link.

Default: True Example: true

ThrowErrorOnFailure : Boolean

True: Throw an exception.

False: Error will be added to the Result.Error.AdditionalInfo list instead of stopping the Task.

Default: True Example: true

ErrorMessageOnFailure : String

Message what will be used when error occurs.

Default: Failed to update message Example: Task failed during execution

Task Result

Name
Description

Success : Boolean

Indicates whether the message was updated successfully. Example: true

MessageTs : String

The timestamp (ID) of the updated message. Example: 1234567890.123456

Error : Error

Error that occurred during task execution. Example: { Message = "Failed to update Slack message.", AdditionalInfo = new Exception("Slack API returned 400 Bad Request") }

Task Changelog

Changelog for Task Frends.Slack.UpdateMessage.

[2.0.0] - 2026-03-04

Fixed

  • Blocks JSON string is now correctly parsed to JArray before sending to Slack API.

  • [Breaking change] - Input.Blocks type changed from JArray to string. Users should now provide raw JSON string instead of parsed JArray.

[1.0.0] - 2025-06-09

Added

  • Initial implementation

Last updated

Was this helpful?