Slack PostEphemeral

Slack PostEphemeral

Certified

Send an ephemeral Slack message

Sends a message visible only to a specific user in the target channel. Ephemeral content disappears when the user leaves the channel view. Requires chat: write.

yaml
type: io.kestra.plugin.slack.app.chats.PostEphemeral

Send an ephemeral message to a user

yaml
id: slack_ephemeral_message
namespace: company.team

tasks:
  - id: post_ephemeral
    type: io.kestra.plugin.slack.app.chats.PostEphemeral
    token: "{{ secret('SLACK_TOKEN') }}"
    channel: "#general"
    user: "U1234567890"
    messageText: "This message is only visible to you"

Send an ephemeral notification

yaml
id: slack_ephemeral_notification
namespace: company.team

tasks:
  - id: notify_user
    type: io.kestra.plugin.slack.app.chats.PostEphemeral
    token: "{{ secret('SLACK_TOKEN') }}"
    channel: "#general"
    user: "U1234567890"
    payload: |
      {
        "text": "Task completed",
        "blocks": [
          {
            "type": "section",
            "text": {
              "type": "mrkdwn",
              "text": ":white_check_mark: Your task has been completed successfully"
            }
          }
        ]
      }
Properties

Slack token

Recipient user ID

User who sees the ephemeral message; must be a member of the channel (IDs usually start with U).

Assets this task consumes as inputs or produces as outputs, for lineage tracking and the asset graph (Enterprise Edition). A flow declaring this property on a task is rejected in the open-source edition.

Definitions
assetFailureBehaviorstring
Possible Values
IGNOREFAILWARN

Asset failure behavior

Behavior applied to the task state when a declared asset fails to render, emit, or be persisted (e.g. a lock conflict): FAIL escalates it to FAILED, WARN (default) warns it if it would otherwise succeed, IGNORE leaves the state untouched.

enableAutobooleanstring

Whether to auto-register assets referenced dynamically at runtime that are not statically declared in inputs or outputs.

inputsarray

The assets consumed as inputs.

id*string
Min length1
typestring
outputs

The assets produced as outputs.

id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*string
Min length1

Custom asset type

descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150

Channel to send message

Channel ID or name; can also be set inside the payload.

Message icon emoji

Emoji code (e.g., : wave: ) that overrides iconUrl.

Message icon URL

HTTPS image used as icon when iconEmoji is not provided.

Message Text or JSON String

The message content as a raw string. It can be plain text with markdown, or a JSON object. If not a valid JSON object, it is automatically wrapped in {"text": "..."}. This property is ignored if the payload property is set.

Slack message payload

Thread timestamp to reply to

Slack ts value for replying in a thread; must belong to the same channel.

Display username

Overrides the bot's default display name for this message.

Timestamp of ephemeral message