Skip to content
Registry

slack

v0.1.17

Slack as an iii worker — exposes the Slack Web API as slack::* functions, plus a harness bridge (inbound events → harness::send, native streaming, approvals). Configurable from the console.

license: Apache-2.0approvalsbotchatmessagingslack

Install

bash
iii trigger compose::add worker=slack

Run in your project with the iii engine running. Exact versions are immutable and digest-pinned.

Functions51

slack::assistant::set-status

Function

Set the assistant-thread status (the thinking indicator).

Request
  • channel_idstringrequired
  • statusstringrequired

    Status text, e.g. `"is thinking..."`. Empty string clears it.

  • thread_tsstringrequired
Response
  • okbooleanrequired

    Slack's success flag (always true here; failures surface as errors).

slack::assistant::set-suggested-prompts

Function

Set suggested prompts for an assistant thread (≤4).

Request
  • channel_idstringrequired
  • promptsobject[]required

    Up to 4 prompts.

    • messagestringrequired

      Text sent to the assistant when the prompt is clicked.

    • titlestringrequired

      Clickable label shown to the user.

  • thread_tsstringrequired
  • titlestring
Response
  • okbooleanrequired

    Slack's success flag (always true here; failures surface as errors).

slack::assistant::set-title

Function

Set the assistant-thread title.

Request
  • channel_idstringrequired
  • thread_tsstringrequired
  • titlestringrequired
Response
  • okbooleanrequired

    Slack's success flag (always true here; failures surface as errors).

slack::auth::test

Function

Check the bot token and return the bot/workspace identity (auth.test).

Request
Empty object
Response
  • okbooleanrequired

    Slack's success flag (always true here; failures surface as errors).

slack::bookmarks::add

Function

Add a bookmark to a channel.

Request
  • channel_idstringrequired
  • linkstring
  • titlestringrequired
  • typestringrequired

    Bookmark type, e.g. `link`.

Response
  • okbooleanrequired

    Slack's success flag (always true here; failures surface as errors).

slack::call

Function

Call any Slack Web API method by name with arbitrary params (escape hatch).

Request
  • as_userboolean

    Use the configured user token (`xoxp-`) instead of the bot token.

  • methodstringrequired

    Slack Web API method name, e.g. `chat.postMessage`, `team.info`.

  • paramsunknown

    Method params object (defaults to `{}`).

Response
  • okbooleanrequired

    Slack's success flag (always true here; failures surface as errors).

slack::chat::delete

Function

Delete a message by ts.

Request
  • channelstringrequired
  • tsstringrequired
Response
  • okbooleanrequired

    Slack's success flag (always true here; failures surface as errors).

slack::chat::post-ephemeral

Function

Post a message visible only to one user.

Request
  • blocksunknown
  • channelstringrequired
  • textstring
  • thread_tsstring
  • userstringrequired

    User who will see the ephemeral message.

Response
  • okbooleanrequired

    Slack's success flag (always true here; failures surface as errors).

slack::chat::post-message

Function

Post a message to a channel, DM, or thread.

Request
  • blocksunknown

    Block Kit blocks (array). Mutually exclusive with `markdown_text`.

  • channelstringrequired

    Channel, DM, or user id to post to (e.g. `C0123ABC` or `U0123ABC`).

  • markdown_textstring

    Markdown body (≤12000 chars). Mutually exclusive with `blocks`/`text`.

  • textstring
  • thread_tsstring

    Parent message ts to reply in a thread.

Response
  • okbooleanrequired

    Slack's success flag (always true here; failures surface as errors).

slack::chat::schedule-message

Function

Schedule a message to post at a future time.

Request
  • blocksunknown
  • channelstringrequired
  • post_atinteger· int64required

    Unix epoch seconds to post at.

  • textstring
  • thread_tsstring
Response
  • okbooleanrequired

    Slack's success flag (always true here; failures surface as errors).

slack::chat::update

Function

Edit an existing message by ts.

Request
  • blocksunknown
  • channelstringrequired
  • markdown_textstring
  • textstring
  • tsstringrequired

    ts of the message to edit.

Response
  • okbooleanrequired

    Slack's success flag (always true here; failures surface as errors).

slack::config-status

Function

Validate the configured Slack credentials and report identity + health (for the console badge).

Request
Empty object
Response
  • bot_idstring
  • bot_user_idstring
  • bridge_enabledbooleanrequired

    Whether the inbound bridge is enabled (socket or http transport configured).

  • enterprise_idstring
  • errorstring
  • okbooleanrequired

    True when the configured bot_token authenticates against Slack.

  • teamstring
  • team_idstring
  • urlstring

slack::conversations::archive

Function

Archive a channel.

Request
  • channelstringrequired
Response
  • okbooleanrequired

    Slack's success flag (always true here; failures surface as errors).

slack::conversations::create

Function

Create a channel.

Request
  • is_privateboolean
  • namestringrequired
Response
  • okbooleanrequired

    Slack's success flag (always true here; failures surface as errors).

slack::conversations::history

Function

Fetch a conversation's message history.

Request
  • channelstringrequired
  • cursorstring
  • lateststring
  • limitinteger· uint32min 0
  • oldeststring
Response
  • okbooleanrequired

    Slack's success flag (always true here; failures surface as errors).

slack::conversations::info

Function

Get metadata for one conversation.

Request
  • channelstringrequired
Response
  • okbooleanrequired

    Slack's success flag (always true here; failures surface as errors).

slack::conversations::invite

Function

Invite users to a channel.

Request
  • channelstringrequired
  • usersstringrequired

    Comma-separated user ids.

Response
  • okbooleanrequired

    Slack's success flag (always true here; failures surface as errors).

slack::conversations::join

Function

Join a public channel.

Request
  • channelstringrequired
Response
  • okbooleanrequired

    Slack's success flag (always true here; failures surface as errors).

slack::conversations::list

Function

List channels/DMs the bot can see.

Request
  • cursorstring
  • exclude_archivedboolean
  • limitinteger· uint32min 0
  • typesstring

    Comma-separated types: `public_channel,private_channel,mpim,im`.

Response
  • okbooleanrequired

    Slack's success flag (always true here; failures surface as errors).

slack::conversations::members

Function

List member ids of a conversation.

Request
  • channelstringrequired
Response
  • okbooleanrequired

    Slack's success flag (always true here; failures surface as errors).

slack::conversations::open

Function

Open a direct message (DM) or group DM channel with users.

Request
  • channelstring
  • usersstring

    Comma-separated user ids to open a DM/MPIM with.

Response
  • okbooleanrequired

    Slack's success flag (always true here; failures surface as errors).

slack::conversations::replies

Function

Fetch the replies in a thread.

Request
  • channelstringrequired
  • cursorstring
  • limitinteger· uint32min 0
  • tsstringrequired

    Parent thread ts.

Response
  • okbooleanrequired

    Slack's success flag (always true here; failures surface as errors).

slack::conversations::set-purpose

Function

Set a channel purpose.

Request
  • channelstringrequired
  • purposestringrequired
Response
  • okbooleanrequired

    Slack's success flag (always true here; failures surface as errors).

slack::conversations::set-topic

Function

Set a channel topic.

Request
  • channelstringrequired
  • topicstringrequired
Response
  • okbooleanrequired

    Slack's success flag (always true here; failures surface as errors).

slack::events

Function

Slack Events API ingress (signature-verified).

Request
  • bodyunknown

    The Slack event envelope (also delivered raw on the request_body channel).

Response
valuenull

slack::files::info

Function

Get metadata for a file.

Request
  • filestringrequired
Response
  • okbooleanrequired

    Slack's success flag (always true here; failures surface as errors).

slack::files::list

Function

List files visible to the bot.

Request
  • channelstring
  • userstring
Response
  • okbooleanrequired

    Slack's success flag (always true here; failures surface as errors).

slack::files::upload

Function

Upload a file to Slack and optionally share it to a channel.

Request
  • channel_idstring

    Channel id to share the file into.

  • contentstring

    UTF-8 text content. Provide this OR `content_base64`.

  • content_base64string

    Base64-encoded binary content. Provide this OR `content`.

  • filenamestringrequired
  • initial_commentstring
  • thread_tsstring
  • titlestring
Response
  • file_idstringrequired
  • okbooleanrequired

slack::interactions

Function

Slack interactivity ingress (block actions / view submissions).

Request
  • bodyunknown

    The url-encoded interactivity body (also delivered raw on the request_body channel).

Response
valuenull

slack::notify

Function

Send a message to the Slack thread bound to a session (out-of-band, e.g. a reminder).

Request
  • blocksunknown

    Optional Block Kit blocks.

  • session_idstringrequired

    A session this bot created (its replies are bound to a Slack thread).

  • textstring

    Message text (markdown). Used unless `blocks` is provided.

Response
  • channelstringrequired
  • deliveredbooleanrequired
  • tsstring

slack::on-config-change

Function

Internal: reload slack configuration from the authoritative store on change.

Request
Empty object
Response
  • okbooleanrequired

slack::on-message-added

Function

Seed the Slack stream for a new assistant entry.

Request
  • entry_idstringrequired
  • messageany of
    any of (2)
    Variant 1
    • contentone of[]
      Show 4 nested
      one of (4)
      Variant 1
      • textstringrequired
      • typestringrequiredenum text
      Variant 2
      • textstringrequired
      • typestringrequiredenum thinking
      Variant 3
      • function_idstringrequired
      • typestringrequiredenum function_call
      Variant 4
      • typestringrequiredenum other
    • rolestringrequired
    Variant 2
    valuenull
  • session_idstringrequired
Response
  • okbooleanrequired

slack::on-message-updated

Function

Stream assistant text revisions into Slack.

Request
  • entry_idstringrequired
  • messageobjectrequired
    • contentone of[]
      one of (4)
      Variant 1
      • textstringrequired
      • typestringrequiredenum text
      Variant 2
      • textstringrequired
      • typestringrequiredenum thinking
      Variant 3
      • function_idstringrequired
      • typestringrequiredenum function_call
      Variant 4
      • typestringrequiredenum other
    • rolestringrequired
  • revisioninteger· uint64requiredmin 0
  • session_idstringrequired
Response
  • okbooleanrequired

slack::on-pending-created

Function

Post an inline Block Kit approval when a tool call is held.

Request
  • arguments_excerptunknown
  • function_call_idstringrequired
  • function_idstringrequired
  • session_idstringrequired
Response
  • okbooleanrequired

slack::on-pending-resolved

Function

Observe approval resolution (button click already cleared the prompt).

Request
  • function_call_idstringrequired
  • outcomestring
  • session_idstringrequired
Response
  • okbooleanrequired

slack::on-turn-completed

Function

Finalize the Slack stream and report turn errors.

Request
  • reasonstring
  • result_errorstring
  • session_idstringrequired
  • statusstringrequired
  • terminalboolean

    `false` while the session still owns an armed wake: the run continues and a later turn carries the real outcome. Missing (legacy harness) → terminal.

  • turn_idstringrequired
Response
  • okbooleanrequired

slack::pins::add

Function

Pin a message to a channel.

Request
  • channelstringrequired
  • timestampstringrequired

    Message ts to pin/unpin.

Response
  • okbooleanrequired

    Slack's success flag (always true here; failures surface as errors).

slack::pins::list

Function

List a channel's pinned items.

Request
  • channelstringrequired
Response
  • okbooleanrequired

    Slack's success flag (always true here; failures surface as errors).

slack::reactions::add

Function

Add an emoji reaction to a message.

Request
  • channelstringrequired
  • namestringrequired

    Emoji name without colons (e.g. `thumbsup`).

  • timestampstringrequired

    Message ts to react to.

Response
  • okbooleanrequired

    Slack's success flag (always true here; failures surface as errors).

slack::reactions::get

Function

Get reactions on a message.

Request
  • channelstringrequired
  • timestampstringrequired
Response
  • okbooleanrequired

    Slack's success flag (always true here; failures surface as errors).

slack::reactions::remove

Function

Remove an emoji reaction from a message.

Request
  • channelstringrequired
  • namestringrequired

    Emoji name without colons (e.g. `thumbsup`).

  • timestampstringrequired

    Message ts to react to.

Response
  • okbooleanrequired

    Slack's success flag (always true here; failures surface as errors).

slack::search::messages

Function

Search messages in the workspace by keyword. Requires a configured user_token.

Request
  • countinteger· uint32min 0
  • cursorstring
  • querystringrequired
  • sortstring
Response
  • okbooleanrequired

    Slack's success flag (always true here; failures surface as errors).

slack::users::info

Function

Get a Slack user's account details: name, timezone, team, and admin/bot flags.

Request
  • userstringrequired
Response
  • okbooleanrequired

    Slack's success flag (always true here; failures surface as errors).

slack::users::list

Function

List workspace users.

Request
  • cursorstring
  • limitinteger· uint32min 0
Response
  • okbooleanrequired

    Slack's success flag (always true here; failures surface as errors).

slack::users::lookup-by-email

Function

Look up a Slack workspace user by their email address.

Request
  • emailstringrequired
Response
  • okbooleanrequired

    Slack's success flag (always true here; failures surface as errors).

slack::users::profile-get

Function

Get a user's profile fields: display name, title, phone, and status.

Request
  • userstring
Response
  • okbooleanrequired

    Slack's success flag (always true here; failures surface as errors).

slack::views::open

Function

Open a Block Kit modal.

Request
  • trigger_idstringrequired

    Interaction trigger_id (expires ~3s after the interaction).

  • viewunknownrequired

    Block Kit view object.

Response
  • okbooleanrequired

    Slack's success flag (always true here; failures surface as errors).

slack::views::publish

Function

Publish the App Home tab for a user.

Request
  • hashstring
  • user_idstringrequired
  • viewunknownrequired

    Block Kit view of type `home`.

Response
  • okbooleanrequired

    Slack's success flag (always true here; failures surface as errors).

slack::views::push

Function

Push a new modal onto the stack.

Request
  • trigger_idstringrequired
  • viewunknownrequired
Response
  • okbooleanrequired

    Slack's success flag (always true here; failures surface as errors).

slack::views::update

Function

Update an open view.

Request
  • external_idstring
  • hashstring
  • viewunknownrequired
  • view_idstring
Response
  • okbooleanrequired

    Slack's success flag (always true here; failures surface as errors).

Triggers0

No triggers registered

Search the registry

Find workers, kits and executables, or jump to a page.