Slack

Team messaging. Send and manage messages, work with channels, threads, and direct messages, look up people, and search history.

Measured routing accuracy

33 golden cases replayed through the router over the whole index: measured over corpus ea4f12ad2948 (65 toolkits, 2283 tools indexed and 13 declared uncallable), 13 cases written by hand and 17 cases from the paraphrase pass, plus 3 context cases whose intent names no app and is decided by the session. A case counts as top-1 when its gold tool ranked first and top-8 when it reached the slate at all.

The sweep is offline: the reranker is a deterministic identity fake that returns candidates in the order retrieval produced them, so top-1 measures retrieval order rather than a reranked slate. just eval-live measures the same cases through the live reranker.

Authentication

Connect an entity with ConnectionsService.InitiateConnection, naming this toolkit's slug. Credentials stay in the connections vault; callers hold connected-account ids only.

oauth2

Tools

35 action tools. The catalog-wide slug is slack.<tool>, which is what search_tools returns and call_tool takes.

slack.send_message

Send a message to a channel, DM, or thread now, immediately. Use when the user wants to post, tell, notify, announce, share, or reply in Slack. Pass thread_ts to reply inside a thread. Not for a later time; for that use schedule_message. For a message only one person can see, use send_ephemeral_message instead.

Class write (writes, no confirmation needed). Scopes chat:write. Calls POST /chat.postMessage.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "drop a note in the channel", "ping the team about something", "give everyone a heads up in there", "shout out to the channel", "let the group know what's going on", "ask something in front of the whole channel".

slack.send_ephemeral_message

Send a message in a channel that only one member can see. Use for a private hint, warning, or confirmation that should not be visible to the whole channel. The message disappears on reload and cannot be edited. For a normal message everyone sees, use send_message.

Class write (writes, no confirmation needed). Scopes chat:write. Calls POST /chat.postEphemeral.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "flag something to just one teammate without the rest seeing", "give someone a quiet heads up nobody else notices", "send a note only that person can see", "whisper a warning to one member", "pop up a private note that vanishes after they read it".

slack.update_message

Edit the text of a message that was already posted. Use when the user wants to fix, correct, or change an existing Slack message. Identify the message by its channel and ts timestamp. Ephemeral messages cannot be edited.

Class write (writes, no confirmation needed). Scopes chat:write. Calls POST /chat.update.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "fix a typo in something I posted", "reword what I already sent", "clean up the wording in my last post", "change what I typed earlier", "tweak the text of something I sent".

slack.delete_message

Delete a message from a channel or DM. Use when the user wants to remove, retract, or take down a message. Permanent; the message cannot be restored. Identify the message by its channel and ts timestamp.

Class destructive (held by the mutation gate until the call's own arguments carry "confirm": true). Scopes chat:write. Calls POST /chat.delete.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "take back something I posted", "erase a post I regret sending", "get rid of that note in the channel", "pull down what I just wrote", "undo something I sent by mistake".

slack.schedule_message

Send a message later, at a chosen future time in a channel or DM. Use when the user says send later, schedule, or remind the channel at a given time. post_at is a Unix timestamp, at most 120 days ahead. To post now, use send_message.

Class write (writes, no confirmation needed). Scopes chat:write. Calls POST /chat.scheduleMessage.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "queue up a note to go out first thing tomorrow", "line up something to send while I'm asleep", "have a reminder post itself at 9am", "set something to go out automatically later", "prep a note that fires off at a specific time".

slack.list_scheduled_messages

List pending scheduled posts not yet delivered, with their ids and delivery times. Use to see what is queued, or to find the id needed by cancel_scheduled_message. Optionally filter by channel or a time window. Does not search message history; for that use search_messages.

Class read (reads only). No scopes beyond the connection's defaults. Calls POST /chat.scheduledMessages.list.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "see what's queued up to go out later", "check what's about to be posted automatically", "show me the upcoming sends I set up", "what reminders are still pending", "review what I lined up for later".

slack.cancel_scheduled_message

Cancel a scheduled message before it is sent. Use when the user wants to stop or undo a message they scheduled. Requires the scheduled_message_id from schedule_message or list_scheduled_messages. Fails within 60 seconds of the delivery time. The cancellation is permanent.

Class destructive (held by the mutation gate until the call's own arguments carry "confirm": true). Scopes chat:write. Calls POST /chat.deleteScheduledMessage.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "pull back something I queued up before it goes out", "call off something I lined up for later", "scrap that reminder before it fires", "stop the queued note from going out", "I changed my mind, don't send that later note".

slack.get_message_permalink

Get a shareable permalink URL for a specific message. Use when the user wants a link to a Slack message to share, bookmark, or reference elsewhere. Identify the message by its channel and message_ts timestamp.

Class read (reads only). No scopes beyond the connection's defaults. Calls GET /chat.getPermalink.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "grab a link to that post so I can share it", "get the url for a specific post", "copy the address of what someone said", "give me something I can paste elsewhere pointing to that post", "I need a link back to that exact post".

slack.list_channels

List channels in the workspace, including private channels and DMs the connected account can see. Use to browse channels, find a channel id from its name, or see what channels exist. For channels a specific person belongs to, use list_user_conversations.

Class read (reads only). Scopes channels:read, groups:read, im:read, mpim:read. Calls GET /conversations.list.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "show me every room that exists here", "what rooms do we have", "browse everything available in the workspace", "give me the full rundown of rooms", "see all the places to talk in this workspace".

slack.get_channel_info

Get details about one channel, DM, or group DM: name, topic, purpose, member count, and archived state. Use when the user asks about a specific channel. For the actual member list, use list_channel_members.

Class read (reads only). Scopes channels:read, groups:read, im:read, mpim:read. Calls GET /conversations.info.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "tell me about this particular room", "what's this room actually for", "give me the details on one room", "how many people are in this one room", "is this room archived or still active".

slack.get_channel_history

Fetch recent messages from a channel or DM, newest first. Use when the user wants to read, catch up on, or summarize what was said in a channel. Returns top-level messages only; use get_thread_replies for the messages inside a thread.

Class read (reads only). Scopes channels:history, groups:history, im:history, mpim:history. Calls GET /conversations.history.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "pull up the last 20 messages from the support room", "what did I miss in there today", "catch me up on what's been said recently", "scroll back through recent chatter", "recap what happened this week", "show me what was said lately".

slack.get_thread_replies

Fetch the messages in one thread, including the parent message. Use when the user wants to read a thread or its replies. Identify the thread by its channel and the parent message's ts. For a channel's top-level messages, use get_channel_history.

Class read (reads only). Scopes channels:history, groups:history, im:history, mpim:history. Calls GET /conversations.replies.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "what did people say back on that thread", "show me the whole conversation under that post", "see every reply under one post", "read the back and forth on that thread", "expand that thread so I can see the replies".

slack.create_channel

Create a new channel, public or private. Use when the user wants to make, start, or set up a channel. Names must be lowercase without spaces or periods, up to 80 characters. A private channel cannot be made public later.

Class write (writes, no confirmation needed). Scopes channels:manage, groups:write. Calls POST /conversations.create.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "spin up a new room for this", "start a place for people to talk about it", "set up a room for the incident responders", "open a fresh room for the launch", "get a new room going".

slack.archive_channel

Archive a channel, hiding it and blocking new messages for every member. Use when the user wants to archive, retire, shut down, or close down a channel for good. History stays searchable and unarchive_channel reverses it, but archiving disrupts all members immediately.

Class destructive (held by the mutation gate until the call's own arguments carry "confirm": true). Scopes channels:manage, groups:write. Calls POST /conversations.archive.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "shut down a room we don't need anymore", "wind down the old hackathon room", "put this room away for good", "mothball a room nobody uses", "close out a room we're done with".

slack.unarchive_channel

Restore an archived channel so members can see it and post again. Use when the user wants to reopen, reactivate, or bring back a channel that was archived.

Class write (writes, no confirmation needed). Scopes channels:manage, groups:write. Calls POST /conversations.unarchive.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "bring back a room that got shelved", "revive an old room we put away", "reopen something we closed down before", "un-shelve that room from before", "make that shelved room active again".

slack.rename_channel

Rename an existing channel, changing its name only. Use when the user wants to change a channel's name. Does not close or archive it. Same naming rules as create_channel: lowercase, no spaces or periods, up to 80 characters. Mentions and links using the old name are not redirected.

Class write (writes, no confirmation needed). Scopes channels:manage, groups:write. Calls POST /conversations.rename.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "call this room something else", "relabel it with a new name", "rebrand this room", "swap out the name of a room", "give this room a different name".

slack.set_channel_topic

Set or change a channel's topic, the short line shown in the channel header. Use when the user wants to update what the channel is currently about. For the longer standing description of the channel, use set_channel_purpose.

Class write (writes, no confirmation needed). Scopes channels:manage, groups:write, im:write, mpim:write. Calls POST /conversations.setTopic.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "put a quick headline on the room", "update what's pinned at the top", "change the one-liner shown up top", "set what shows next to the room's name", "update the short blurb everyone sees first".

slack.set_channel_purpose

Set or change a channel's purpose, the standing description of why the channel exists. Use when the user wants to update a channel's description. For the short header line that changes day to day, use set_channel_topic.

Class write (writes, no confirmation needed). Scopes channels:manage, groups:write, im:write, mpim:write. Calls POST /conversations.setPurpose.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "explain what this room is for", "write up why this room exists", "describe the point of this room", "set the long-term description for a room", "fill in what this room is meant for".

slack.invite_to_channel

Invite one or more people to a channel. Use when the user wants to add members to a channel. Pass user ids comma separated, up to 1000 at once. Resolve ids with find_user_by_email or list_users.

Class write (writes, no confirmation needed). Scopes channels:manage, groups:write. Calls POST /conversations.invite.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "add someone to a room", "bring a new person into a room", "loop a teammate into a room", "get a coworker added to this room", "pull someone into the conversation".

slack.remove_from_channel

Remove a person from a channel. Use when the user wants to kick or take someone out of a channel. The person loses access immediately and must be re-invited to return.

Class destructive (held by the mutation gate until the call's own arguments carry "confirm": true). Scopes channels:manage, groups:write. Calls POST /conversations.kick.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "kick someone out of a room", "boot a person from this room", "cut off someone's access to a room", "take a teammate out of a room", "remove one person's access".

slack.join_channel

Join a public channel. Use when the user wants to join, follow, or start participating in a channel. Works on public channels only; joining a private channel requires an invitation from a member.

Class write (writes, no confirmation needed). Scopes channels:join. Calls POST /conversations.join.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "hop into a public room", "get myself added to a room", "start following along in a room", "sign myself up for a room", "become part of that room".

slack.leave_channel

Leave a channel. Use when the user wants to leave or exit a channel they are in. A public channel can be rejoined later with join_channel; leaving a private channel requires a new invitation to return.

Class write (writes, no confirmation needed). Scopes channels:manage, groups:write, im:write, mpim:write. Calls POST /conversations.leave.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "step out of a room I'm in", "drop out of a room I don't need anymore", "get myself out of this room", "stop being part of a room", "exit a conversation I'm done with".

slack.open_dm

Open a direct message with one person or a group DM with up to eight people. Use when the user wants to start or resume a DM. Returns the conversation id to pass as channel to send_message. Pass user ids comma separated.

Class write (writes, no confirmation needed). Scopes im:write, mpim:write. Calls POST /conversations.open.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "start a private chat with a coworker", "message someone directly instead of a room", "open a one on one conversation", "get a small group chat going with a few people", "begin a direct line to someone".

slack.close_dm

Close a direct message or group DM, removing it from the sidebar. Use when the user wants to close or hide a DM. No history is deleted; opening the conversation again brings it back.

Class write (writes, no confirmation needed). Scopes im:write, mpim:write. Calls POST /conversations.close.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "hide a direct chat from my sidebar", "tidy up my list of conversations", "get a private chat out of my view", "put away a private chat I'm not using", "clear a conversation off my sidebar".

slack.list_channel_members

List the user ids of everyone in a channel. Use when the user asks who is in a channel or how many people it has. Resolve the ids to names with get_user_info.

Class read (reads only). Scopes channels:read, groups:read, im:read, mpim:read. Calls GET /conversations.members.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "who is in the platform oncall channel right now", "see everyone in a room", "channel roster", "who's part of this room", "how many people are actually in here", "give me the full lineup for a room".

slack.list_users

List everyone in the workspace with their ids, names, and profile basics. Use to browse members or resolve a display name to a user id. To look someone up by email address, use find_user_by_email instead of paging this list.

Class read (reads only). Scopes users:read. Calls GET /users.list.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "show me everyone on the team", "pull up the whole company directory", "see every person in the workspace", "who works here", "browse the full roster of people".

slack.get_user_info

Get a workspace member's details by user id: real name, display name, title, email, time zone, and bot or deactivated flags. Use when the user asks who someone is. If you only have an email address, use find_user_by_email.

Class read (reads only). Scopes users:read. Calls GET /users.info.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "look someone up by their id", "what's this person's job title", "find out someone's time zone", "get the lowdown on a teammate", "who exactly is this person".

slack.find_user_by_email

Find a workspace member by their email address and return their user id and profile. Use when the user identifies a person by email, or when you need a user id for messaging or inviting and only have an email.

Class read (reads only). Scopes users:read.email. Calls GET /users.lookupByEmail.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "who in the workspace has this email address", "match an email address to a real person", "figure out whose email this is", "look someone up using just their email", "find the account tied to an address".

slack.get_user_presence

Check whether a person is currently active or away in Slack. Use when the user asks if someone is online, around, or available right now.

Class read (reads only). Scopes users:read. Calls GET /users.getPresence.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "is she online right now", "check if someone is at their desk", "see if a teammate is free to chat", "is he around at the moment", "find out if someone's active right now".

slack.set_user_presence

Set the connected account's own presence to away, or back to auto so it follows their activity again. Use when the user wants to appear away or reset their presence. To set a status message, use set_user_status.

Class write (writes, no confirmation needed). Scopes users:write. Calls POST /users.setPresence.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "make it look like I stepped away", "go invisible for a bit", "turn my status back to automatic", "stop showing myself as active", "reset my own online indicator".

slack.get_user_profile

Get a person's profile fields, including their current status text and status emoji. Use when the user asks what someone's status is or wants full profile details. For basic identity plus email, get_user_info is usually enough.

Class read (reads only). Scopes users.profile:read. Calls GET /users.profile.get.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "what does someone's status say right now", "check a teammate's bio", "see the emoji next to someone's name", "pull up someone's full details", "what is this person's current status".

slack.set_user_status

Set the connected account's Slack status: the text and emoji shown next to their name. Use when the user wants to set, change, or clear their status. Pass empty strings to clear it. To appear away instead, use set_user_presence.

Class write (writes, no confirmation needed). Scopes users.profile:write. Calls POST /users.profile.set.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "put a little note next to my name", "add an emoji badge to my profile", "clear whatever status I have up", "change what shows beside my name right now", "let people know I'm on vacation with an emoji".

slack.list_user_conversations

List the channels and DMs a specific person is a member of. Use when the user asks what channels someone is in. Defaults to the connected account when user is omitted. For every channel in the workspace regardless of membership, use list_channels.

Class read (reads only). Scopes channels:read, groups:read, im:read, mpim:read. Calls GET /users.conversations.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "which rooms is a specific person in", "where does this teammate spend their time", "see every room someone belongs to", "what conversations is this person part of", "find all the rooms one coworker joined".

slack.search_messages

Search messages across the whole workspace by keyword. Use when the user wants to find, look up, or dig up what someone said, a decision, or a link, and does not know which channel it is in. Supports modifiers like from:@name, in:#channel, before:, after:. Runs as the connected user. For files and uploads, use search_files.

Class read (reads only). Scopes search:read. Calls GET /search.messages.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "look up what someone said", "find where something was mentioned", "dig through old chats for a specific word", "track down who said what about a topic", "hunt for a conversation I can't remember the room of", "find where a decision or number was shared".

slack.search_files

Search files shared in the workspace by keyword: documents, images, snippets, and uploads. Use when the user is looking for a file rather than a conversation. Supports modifiers like from:@name and in:#channel. Runs as the connected user. For messages, use search_messages.

Class read (reads only). Scopes search:read. Calls GET /search.files.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "find that pdf someone shared", "track down an attachment from a while back", "dig up a document someone uploaded", "look for an image someone posted", "locate a file without remembering who sent it".

Triggers

Triggers are app-initiated. They are not retrievable as tools and cannot be called; subscribe with TriggersService.CreateSubscription and events arrive as signed deliveries.

message_posted

Fires when a message is posted in a channel the app is a member of. Carries the channel, author, text, and thread timestamp.

Payload fields (anything the schema does not declare never reaches a subscriber):

app_mention

Fires when someone mentions the app in a channel. Carries the channel, author, full message text, and thread timestamp.

Payload fields (anything the schema does not declare never reaches a subscriber):

Inbound webhooks

Providers post to /webhooks/slack. Posts that fail verification are rejected before anything is stored, and the ingest path refuses every post while the secret variable is unset.

Mappings are tried in order and the first match wins.