# Slack

Slack is a channel-based messaging platform. With Slack, people can work together more effectively, connect all their software tools and services, and find the information they need to do their best work — all within a secure, enterprise-grade environment.

- **Category:** team chat
- **Auth:** OAUTH2
- **Tools:** 155
- **Triggers:** 9
- **Slug:** `SLACK`
- **Version:** 20260217_00

## Frequently Asked Questions

### How do I set up custom OAuth credentials for Slack?

For a step-by-step guide on creating and configuring your own Slack OAuth credentials with Devcaster, see [How to create OAuth credentials for Slack](https://devcaster.dev/auth/slack).

### What is the difference between Slack and Slackbot toolkits?

Slack is for workspace-level API access (channels, files, users) while Slackbot is bot-centric (messaging, interactivity). Slack triggers cover workspace events; Slackbot covers bot entry points like app mentions, DMs, and slash commands. Slack can post as the app; Slackbot posts as the bot user.

### Where can I find Slack's available scopes?

See the [Slack scopes reference](https://docs.slack.dev/reference/scopes/).

### Why am I getting a redirect URI mismatch error?

Update the redirect URL in your Slack App under OAuth & Permissions → Redirect URLs.

### How do I set up Slack event webhooks?

Enable Event Subscriptions in your Slack app. Set the Request URL to `https://backend.devcaster.dev/api/v3/trigger_instances/slack/default/handle`. Add events (e.g., `reaction_added`) to Subscribe to Bot Events and save. If using the Slackbot integration, add the bot to the channels you want to monitor.

### Why am I getting scope errors on Slack?

Either you're missing a bot scope (add one under OAuth & Permissions) or you have "Insufficient scopes" (ensure all scopes from your auth config are configured in the Slack app).

### What does the `as_user` parameter do in Slack tools?

For the Slack toolkit, set `as_user=True` to post as the authenticated user. For Slackbot, leave it blank (defaults to false). A `missing_charset` error usually means invalid `as_user`, wrong channel ID, or missing required fields.

### Why aren't my Slack triggers working?

Provide the Verification Token or signing secret in the auth config so Devcaster can validate incoming events.

---

## Tools

### Add an emoji alias

**Slug:** `SLACK_ADD_AN_EMOJI_ALIAS_IN_SLACK`

Adds an alias for an existing custom emoji in a Slack Enterprise Grid organization.

### Add a remote file

**Slug:** `SLACK_ADD_A_REMOTE_FILE_FROM_A_SERVICE`

Adds a reference to an external file (e.g., Google Drive, Dropbox) to Slack for discovery and sharing, requiring a unique `external_id` and an `external_url` accessible by Slack.

### Add a star to an item

**Slug:** `SLACK_ADD_A_STAR_TO_AN_ITEM`

Stars a channel, file, file comment, or a specific message in Slack.

### Add call participants

**Slug:** `SLACK_ADD_CALL_PARTICIPANTS`

Registers new participants added to a Slack call.

### Add emoji

**Slug:** `SLACK_ADD_EMOJI`

Adds a custom emoji to a Slack workspace given a unique name and an image URL; subject to workspace emoji limits.

### Add Enterprise user to workspace

**Slug:** `SLACK_ADD_ENTERPRISE_USER_TO_WORKSPACE`

Adds an Enterprise user to a workspace. Use when you need to assign an existing Enterprise Grid user to a specific workspace with optional guest restrictions.

### Add reaction to message

**Slug:** `SLACK_ADD_REACTION_TO_AN_ITEM`

Adds a specified emoji reaction to an existing message in a Slack channel, identified by its timestamp; does not remove or retrieve reactions.

### List approved apps

**Slug:** `SLACK_ADMIN_APPS_APPROVED_LIST`

Tool to list approved apps for an Enterprise Grid organization or workspace. Use when you need to retrieve the list of apps that have been approved for installation by workspace admins. Requires admin.apps:read scope and a user token from an org owner/admin context.

### List app requests

**Slug:** `SLACK_ADMIN_APPS_REQUESTS_LIST`

Tool to list pending app installation requests for a team/workspace. Use when you need to see which apps users have requested to install that haven't yet been approved or denied. Requires Enterprise Grid or Business+ plan with admin.apps:read scope.

### Search for channels in Enterprise organization

**Slug:** `SLACK_ADMIN_CONVERSATIONS_SEARCH`

Tool to search for public or private channels in an Enterprise organization. Use when you need to find channels by name, type, or other criteria within an Enterprise Grid workspace.

### Test Slack API connection

**Slug:** `SLACK_API_TEST`

Tool to check API calling code by testing connectivity and authentication to the Slack API. Use when you need to verify that API credentials are valid and the connection is working properly.

### Archive a public or private channel

**Slug:** `SLACK_ARCHIVE_A_PUBLIC_OR_PRIVATE_CHANNEL`

Archives a Slack public or private channel, making it read-only; the primary 'general' channel cannot be archived.

### Archive a Slack conversation

**Slug:** `SLACK_ARCHIVE_A_SLACK_CONVERSATION`

Archives a Slack conversation by its ID, rendering it read-only and hidden while retaining history, ideal for cleaning up inactive channels; be aware that some channels (like #general or certain DMs) cannot be archived and this may impact connected integrations.

### Clear Slack Status

**Slug:** `SLACK_CLEAR_STATUS`

Clears the Slack status for the authenticated user, removing any custom text and emoji.

### Close conversation channel

**Slug:** `SLACK_CLOSE_DM_OR_MULTI_PERSON_DM`

Closes a Slack direct message (DM) or multi-person direct message (MPDM) channel, removing it from the user's sidebar without deleting history; this action affects only the calling user's view.

### Convert public channel to private

**Slug:** `SLACK_CONVERT_PUBLIC_CHANNEL_TO_PRIVATE`

Convert a public Slack channel to private using the Admin API. This is an Enterprise Grid only feature and requires an org-installed user token with admin.conversations:write scope.

### Create a reminder

**Slug:** `SLACK_CREATE_A_REMINDER`

Creates a Slack reminder with specified text and time; time accepts Unix timestamps, seconds from now, or natural language (e.g., 'in 15 minutes', 'every Thursday at 2pm').

### Create a Slack user group

**Slug:** `SLACK_CREATE_A_SLACK_USER_GROUP`

Creates a new User Group (often referred to as a subteam) in a Slack workspace.

### Create Slack Canvas

**Slug:** `SLACK_CREATE_CANVAS`

Creates a new Slack Canvas with the specified title and optional content.

### Create channel

**Slug:** `SLACK_CREATE_CHANNEL`

Initiates a public or private channel-based conversation

### Create a channel-based conversation

**Slug:** `SLACK_CREATE_CHANNEL_BASED_CONVERSATION`

Creates a new public or private Slack channel with a unique name; the channel can be org-wide, or team-specific if `team_id` is given (required if `org_wide` is false or not provided).

### Create Enterprise team

**Slug:** `SLACK_CREATE_ENTERPRISE_TEAM`

Tool to create an Enterprise team in Slack. Use when you need to create a new team (workspace) within an Enterprise Grid organization. Requires admin.teams:write scope.

### Customize URL unfurl

**Slug:** `SLACK_CUSTOMIZE_URL_UNFURL`

Customizes URL previews (unfurling) in a specific Slack message using a URL-encoded JSON in `unfurls` to define custom content or remove existing previews.

### Delete file comment

**Slug:** `SLACK_DELETE_A_COMMENT_ON_A_FILE`

Deletes a specific comment from a file in Slack; this action is irreversible.

### Delete a file by ID

**Slug:** `SLACK_DELETE_A_FILE_BY_ID`

Permanently deletes an existing file from a Slack workspace using its unique file ID; this action is irreversible and also removes any associated comments or shares.

### Delete a public or private channel

**Slug:** `SLACK_DELETE_A_PUBLIC_OR_PRIVATE_CHANNEL`

Permanently and irreversibly deletes a specified public or private channel, including all its messages and files, within a Slack Enterprise Grid organization.

### Delete scheduled chat message

**Slug:** `SLACK_DELETE_A_SCHEDULED_MESSAGE_IN_A_CHAT`

Deletes a pending, unsent scheduled message from the specified Slack channel, identified by its `scheduled_message_id`.

### Delete a Slack reminder

**Slug:** `SLACK_DELETE_A_SLACK_REMINDER`

Deletes an existing Slack reminder, typically when it is no longer relevant or a task is completed; this operation is irreversible.

### Delete Slack Canvas

**Slug:** `SLACK_DELETE_CANVAS`

Deletes a Slack Canvas permanently.

### Delete a message from a chat

**Slug:** `SLACK_DELETES_A_MESSAGE_FROM_A_CHAT`

Deletes a message, identified by its channel ID and timestamp, from a Slack channel, private group, or direct message conversation; the authenticated user or bot must be the original poster.

### Delete user profile photo

**Slug:** `SLACK_DELETE_USER_PROFILE_PHOTO`

Deletes the Slack profile photo for the user identified by the token, reverting them to the default avatar; this action is irreversible and succeeds even if no custom photo was set.

### Disable a Slack user group

**Slug:** `SLACK_DISABLE_AN_EXISTING_SLACK_USER_GROUP`

Disables a specified, currently enabled Slack User Group by its unique ID, effectively archiving it by setting its 'date_delete' timestamp; the group is not permanently deleted and can be re-enabled.

### Download Slack file

**Slug:** `SLACK_DOWNLOAD_SLACK_FILE`

Tool to download Slack file content and convert it to a publicly accessible URL. Use when you need to retrieve and download files that have been shared in Slack channels or conversations.

### Edit Slack Canvas

**Slug:** `SLACK_EDIT_CANVAS`

Edits a Slack Canvas with granular control over content placement. Supports replace, insert (before/after/start/end) operations for flexible content management.

### Enable a user group

**Slug:** `SLACK_ENABLE_A_SPECIFIED_USER_GROUP`

Enables a disabled User Group in Slack using its ID, reactivating it for mentions and permissions; this action only changes the enabled status and cannot create new groups or modify other properties.

### Share file public url

**Slug:** `SLACK_ENABLE_PUBLIC_SHARING_OF_A_FILE`

Enables public sharing for an existing Slack file by generating a publicly accessible URL; this action does not create new files.

### End a call

**Slug:** `SLACK_END_A_CALL_WITH_DURATION_AND_ID`

Ends an ongoing Slack call, identified by its ID (obtained from `calls.add`), optionally specifying the call's duration.

### End snooze

**Slug:** `SLACK_END_SNOOZE`

Ends the current user's snooze mode immediately.

### End DND session

**Slug:** `SLACK_END_USER_DO_NOT_DISTURB_SESSION`

Ends the authenticated user's current Do Not Disturb (DND) session in Slack, affecting only DND status and making them available; if DND is not active, Slack acknowledges the request without changing status.

### Fetch bot user information

**Slug:** `SLACK_FETCH_BOT_USER_INFORMATION`

Fetches information for a specified, existing Slack bot user; will not work for regular user accounts or other integration types.

### Fetch conversation history

**Slug:** `SLACK_FETCH_CONVERSATION_HISTORY`

Fetches a chronological list of messages and events from a specified Slack conversation, accessible by the authenticated user/bot, with options for pagination and time range filtering. IMPORTANT LIMITATION: This action only returns messages from the main channel timeline. Threaded replies are NOT returned by this endpoint. To retrieve threaded replies, use the SLACK_FETCH_MESSAGE_THREAD_FROM_A_CONVERSATION action (conversations.replies API) instead. The oldest/latest timestamp filters work reliably for filtering the main channel timeline, but cannot be used to retrieve individual threaded replies - even if you know the exact reply timestamp, setting oldest=latest to that timestamp will return an empty messages array. To get threaded replies: 1. Use this action to get parent messages (which include thread_ts, reply_count, latest_reply fields) 2. Use SLACK_FETCH_MESSAGE_THREAD_FROM_A_CONVERSATION with the parent's thread_ts to fetch all replies in that thread

### Get Do Not Disturb status for users

**Slug:** `SLACK_FETCH_DND_STATUS_FOR_MULTIPLE_TEAM_MEMBERS`

DEPRECATED: Retrieves a user's current Do Not Disturb status. Use `get_team_dnd_status` instead.

### Fetch item reactions

**Slug:** `SLACK_FETCH_ITEM_REACTIONS`

Fetches reactions for a Slack message, file, or file comment, requiring one of: channel and timestamp; file ID; or file comment ID.

### Retrieve conversation replies

**Slug:** `SLACK_FETCH_MESSAGE_THREAD_FROM_A_CONVERSATION`

Retrieves replies to a specific parent message in a Slack conversation, using the channel ID and the parent message's timestamp (`ts`). Note: The parent message in the response contains metadata (reply_count, reply_users, latest_reply) that indicates expected thread activity. If the returned messages array contains fewer replies than reply_count indicates, check: (1) has_more=true means pagination is needed, (2) recently posted replies may have timing delays, (3) some replies may be filtered by permissions or deleted. The composio_execution_message field will warn about any detected mismatches.

### Fetch team info

**Slug:** `SLACK_FETCH_TEAM_INFO`

Fetches comprehensive metadata about the current Slack team, or a specified team if the provided ID is accessible.

### Fetch workspace settings information

**Slug:** `SLACK_FETCH_WORKSPACE_SETTINGS_INFORMATION`

Retrieves detailed settings for a specific Slack workspace, primarily for administrators in an Enterprise Grid organization to view or audit workspace configurations.

### Find channels

**Slug:** `SLACK_FIND_CHANNELS`

Find channels in a Slack workspace by any criteria - name, topic, purpose, or description. NOTE: This action can only search channels visible to the bot. Empty results may indicate: - No channels match the search query in name, topic, or purpose - The target channel is private and the bot hasn't been invited - The bot lacks required scopes (channels:read, groups:read) Check 'composio_execution_message' and 'total_channels_searched' in the response for details.

### Lookup users by email

**Slug:** `SLACK_FIND_USER_BY_EMAIL_ADDRESS`

Retrieves the Slack user object for an active user by their registered email address; fails with 'users_not_found' if the email is unregistered or the user is inactive.

### Find users

**Slug:** `SLACK_FIND_USERS`

Find users in a Slack workspace by any criteria - email, name, display name, or other text. Includes optimized email lookup for exact email matches.

### Get app permission scopes

**Slug:** `SLACK_GET_APP_PERMISSION_SCOPES`

Preflight a Slack token by calling auth.test and returning the token's currently granted OAuth scopes (from response headers) to detect missing permissions before attempting admin actions. Use when you need to verify token capabilities or check for specific scopes before making API calls that require elevated permissions.

### Get Audit Action Types

**Slug:** `SLACK_GET_AUDIT_ACTION_TYPES`

Tool to retrieve information about action types available in the Slack Audit Logs API. Use when you need to know which action types can be used to filter audit logs or understand the categories of auditable actions in Slack.

### Get Audit Schemas

**Slug:** `SLACK_GET_AUDIT_SCHEMAS`

Tool to retrieve object schema information from the Slack Audit Logs API. Use when you need to understand the types of objects returned by audit log endpoints. Returns a list of all object types with descriptions.

### Get Slack Canvas

**Slug:** `SLACK_GET_CANVAS`

Retrieves a specific Slack Canvas by its ID, including its content and metadata.

### Get channel conversation preferences

**Slug:** `SLACK_GET_CHANNEL_CONVERSATION_PREFERENCES`

Retrieves conversation preferences (e.g., who can post, who can thread) for a specified channel, primarily for use within Slack Enterprise Grid environments.

### Get reminder information

**Slug:** `SLACK_GET_REMINDER_INFORMATION`

Retrieves detailed information for an existing Slack reminder specified by its ID; this is a read-only operation.

### Get remote file

**Slug:** `SLACK_GET_REMOTE_FILE`

Retrieve information about a remote file added to Slack.

### Retrieve user presence

**Slug:** `SLACK_GET_USER_PRESENCE_INFO`

Retrieves a Slack user's current real-time presence (e.g., 'active', 'away') to determine their availability, noting this action does not provide historical data or status reasons.

### Get workspace connections for channel

**Slug:** `SLACK_GET_WORKSPACE_CONNECTIONS_FOR_CHANNEL`

Tool to get all workspaces a channel is connected to within an Enterprise org. Use when you need to determine which workspaces have access to a specific public or private channel in an Enterprise Grid organization.

### Invite users to a Slack channel

**Slug:** `SLACK_INVITE_USERS_TO_A_SLACK_CHANNEL`

Invites users to an existing Slack channel using their valid Slack User IDs.

### Invite users to channel

**Slug:** `SLACK_INVITE_USER_TO_CHANNEL`

Invites users to a specified Slack channel; this action is restricted to Enterprise Grid workspaces and requires the authenticated user to be a member of the target channel.

### Invite user to workspace

**Slug:** `SLACK_INVITE_USER_TO_WORKSPACE`

Invites a user to a Slack workspace and specified channels by email; use `resend=True` to re-process an existing invitation for a user not yet signed up.

### Join conversation by channel id

**Slug:** `SLACK_JOIN_AN_EXISTING_CONVERSATION`

Joins an existing Slack conversation (public channel, private channel, or multi-person direct message) by its ID, if the authenticated user has permission.

### Leave conversation channel

**Slug:** `SLACK_LEAVE_A_CONVERSATION`

Leaves a Slack conversation given its channel ID; fails if leaving as the last member of a private channel or if used on a Slack Connect channel.

### List admin emoji

**Slug:** `SLACK_LIST_ADMIN_EMOJI`

List custom emoji across an Enterprise Grid organization. Use when you need to retrieve all custom emoji for an entire Enterprise Grid org (not just a single workspace). Requires admin.teams:read scope and an admin token. For single workspace emoji, use the regular emoji.list method instead.

### List all channels

**Slug:** `SLACK_LIST_ALL_CHANNELS`

Lists conversations available to the user with various filters and search options.

### List all users

**Slug:** `SLACK_LIST_ALL_USERS`

Retrieves a paginated list of all users, including comprehensive details, profile information, status, and team memberships, in a Slack workspace; data may not be real-time.

### List all users in a user group

**Slug:** `SLACK_LIST_ALL_USERS_IN_A_USER_GROUP`

Retrieves a list of all user IDs within a specified Slack user group, with an option to include users from disabled groups.

### List approved workspace invite requests

**Slug:** `SLACK_LIST_APPROVED_WORKSPACE_INVITE_REQUESTS`

List all approved workspace invite requests with pagination support. Use to review which invite requests have been approved and the details of each approval. Requires admin.invites:read scope and Enterprise Grid organization.

### List authorized teams

**Slug:** `SLACK_LIST_AUTH_TEAMS`

Obtains a paginated list of workspaces your org-wide app has been approved for. Use when you need to discover all workspaces within an organization where the app is installed.

### List Slack Canvases

**Slug:** `SLACK_LIST_CANVASES`

Lists Slack Canvases with filtering by channel, user, timestamp, and page-based pagination. Uses Slack's files.list API with types=canvas filter. Known limitations: - The 'user' filter may return canvases accessible to the specified user, not just canvases they created. This is a known behavior of the Slack files.list API with canvas types. - The 'ts_from' and 'ts_to' timestamp filters may not work reliably for canvas types. Consider using client-side filtering on the 'created' field in the response if precise date filtering is required.

### List conversations

**Slug:** `SLACK_LIST_CONVERSATIONS`

List conversations (channels/DMs) accessible to a specified user (or the authenticated user if no user ID is provided), respecting shared membership for non-public channels.

### List denied workspace invite requests

**Slug:** `SLACK_LIST_DENIED_WORKSPACE_INVITE_REQUESTS`

Tool to list all denied workspace invite requests with details about who denied them and when. Use when you need to review or audit denied invitation requests.

### List Enterprise teams

**Slug:** `SLACK_LIST_ENTERPRISE_TEAMS`

List all teams (workspaces) in a Slack Enterprise Grid organization with pagination support. Use when you need to retrieve team IDs, names, domains, and metadata for all workspaces in an Enterprise. Requires admin.teams:read scope and Enterprise Grid organization.

### List Slack files

**Slug:** `SLACK_LIST_FILES_WITH_FILTERS_IN_SLACK`

Lists files and their metadata within a Slack workspace, filterable by user, channel, timestamp, or type; this action returns metadata only, not file content.

### List IDP groups linked to channel

**Slug:** `SLACK_LIST_IDP_GROUPS_LINKED_TO_CHANNEL`

Lists IDP groups that have restricted access to a private Slack channel. Use when you need to see which identity provider groups can access a specific channel.

### List pending workspace invite requests

**Slug:** `SLACK_LIST_PENDING_WORKSPACE_INVITE_REQUESTS`

Tool to list all pending workspace invite requests. Use when you need to see who has been invited but hasn't joined yet. Requires admin.invites:read scope.

### List reminders

**Slug:** `SLACK_LIST_REMINDERS`

Lists all reminders with their details for the authenticated Slack user; returns an empty list if no reminders exist.

### List remote files

**Slug:** `SLACK_LIST_REMOTE_FILES`

Retrieve information about a team's remote files.

### List Restricted Apps

**Slug:** `SLACK_LIST_RESTRICTED_APPS_FOR_ORG_OR_WORKSPACE`

Tool to list restricted apps for an org or workspace. Use when you need to view apps that have been restricted from installation. Requires admin.apps:read scope and appropriate admin permissions.

### List scheduled messages

**Slug:** `SLACK_LIST_SCHEDULED_MESSAGES`

Retrieves a list of pending (not yet delivered) messages scheduled in a specific Slack channel, or across all accessible channels if no channel ID is provided, optionally filtered by time and paginated.

### List pinned items in a channel

**Slug:** `SLACK_LISTS_PINNED_ITEMS_IN_A_CHANNEL`

Retrieves all messages and files pinned to a specified channel; the caller must have access to this channel.

### List starred items

**Slug:** `SLACK_LIST_STARRED_ITEMS`

Lists items starred by a user.

### List team custom emojis

**Slug:** `SLACK_LIST_TEAM_CUSTOM_EMOJIS`

Retrieves all custom emojis for the Slack workspace (image URLs or aliases), not standard Unicode emojis; does not include usage statistics or creation dates.

### List user groups

**Slug:** `SLACK_LIST_USER_GROUPS_FOR_TEAM_WITH_OPTIONS`

Lists user groups in a Slack workspace, including user-created and default groups; results for large workspaces may be paginated.

### List user reactions

**Slug:** `SLACK_LIST_USER_REACTIONS`

Lists all reactions added by a specific user to messages, files, or file comments in Slack, useful for engagement analysis when the item content itself is not required.

### List workspace admins

**Slug:** `SLACK_LIST_WORKSPACE_ADMINS`

Tool to list all admins on a given Slack workspace. Use when you need to identify workspace administrators. Requires Enterprise Grid organization and admin.teams:read scope.

### List workspace owners

**Slug:** `SLACK_LIST_WORKSPACE_OWNERS`

Tool to list all owners on a given Slack workspace. Use when you need to identify workspace ownership or admin structure. Requires admin.teams:read scope.

### List admin users

**Slug:** `SLACK_LIST_WORKSPACE_USERS`

Retrieves a paginated list of admin users for a specified Slack workspace.

### Lookup Canvas Sections

**Slug:** `SLACK_LOOKUP_CANVAS_SECTIONS`

Looks up section IDs in a Slack Canvas for use with targeted edit operations. Section IDs are needed for insert_after, insert_before, delete, and section-specific replace operations.

### Set user presence

**Slug:** `SLACK_MANUALLY_SET_USER_PRESENCE`

Manually sets a user's Slack presence, overriding automatic detection; this setting persists across connections but can be overridden by user actions or Slack's auto-away (e.g., after 10 mins of inactivity).

### Mark reminder as complete

**Slug:** `SLACK_MARK_REMINDER_AS_COMPLETE`

Marks a specific Slack reminder as complete using its `reminder` ID; **DEPRECATED**: This Slack API endpoint ('reminders.complete') was deprecated in March 2023 and is not recommended for new applications.

### Open DM

**Slug:** `SLACK_OPEN_DM`

Opens or resumes a Slack direct message (DM) or multi-person direct message (MPIM) by providing either user IDs or an existing channel ID.

### Pin an item to a channel

**Slug:** `SLACK_PINS_AN_ITEM_TO_A_CHANNEL`

Pins a message to a specified Slack channel; the message must not already be pinned.

### Read Audit Logs

**Slug:** `SLACK_READ_AUDIT_LOGS`

Read Slack Enterprise Grid Audit Logs (logins, admin changes, app installs, channel/privacy changes, etc.) with server-side filters and pagination. Requires Enterprise Grid organization with auditlogs:read scope and a user token (xoxp-...) from an owner/admin context.

### Remove remote file

**Slug:** `SLACK_REMOVE_A_REMOTE_FILE`

Removes the Slack reference to an external file (which must have been previously added via the remote files API), specified by either its `external_id` or `file` ID (one of which is required), without deleting the actual external file.

### Remove a star from an item

**Slug:** `SLACK_REMOVE_A_STAR_FROM_AN_ITEM`

Removes a star from a previously starred Slack item (message, file, file comment, channel, group, or DM), requiring identification via `file`, `file_comment`, `channel` (for channel/group/DM), or both `channel` and `timestamp` (for a message).

### Remove user from conversation

**Slug:** `SLACK_REMOVE_A_USER_FROM_A_CONVERSATION`

Removes a specified user from a Slack conversation (channel); the caller must have permissions to remove users and cannot remove themselves using this action.

### Remove call participants

**Slug:** `SLACK_REMOVE_CALL_PARTICIPANTS`

Registers participants removed from a Slack call.

### Remove emoji

**Slug:** `SLACK_REMOVE_EMOJI`

Tool to remove a custom emoji across an Enterprise Grid organization. Use when you need to delete a custom emoji from the entire organization.

### Remove reaction from item

**Slug:** `SLACK_REMOVE_REACTION_FROM_ITEM`

Removes an emoji reaction from a message, file, or file comment in Slack.

### Remove user from workspace

**Slug:** `SLACK_REMOVE_USER_FROM_WORKSPACE`

Tool to remove a user from a Slack workspace. Use when you need to revoke a user's access to a workspace.

### Rename a conversation

**Slug:** `SLACK_RENAME_A_CONVERSATION`

Renames a Slack channel, automatically adjusting the new name to meet naming conventions (e.g., converting to lowercase), which may affect integrations using the old name.

### Rename an emoji

**Slug:** `SLACK_RENAME_AN_EMOJI`

Renames an existing custom emoji in a Slack workspace, updating all its instances.

### Rename a Slack channel

**Slug:** `SLACK_RENAME_A_SLACK_CHANNEL`

Renames a public or private Slack channel; for Enterprise Grid workspaces, the user must be a Workspace Admin or Channel Manager.

### Reset user sessions

**Slug:** `SLACK_RESET_USER_SESSIONS`

Tool to wipe all valid sessions on all devices for a given user. Use when you need to force a user to re-authenticate due to security concerns or account changes.

### Restrict app installation

**Slug:** `SLACK_RESTRICT_APP_INSTALLATION`

Restrict an app for installation on a workspace. Use when you need to prevent an app from being installed on a specific workspace or enterprise organization.

### Retrieve a user's identity details

**Slug:** `SLACK_RETRIEVE_A_USER_S_IDENTITY_DETAILS`

Retrieves the authenticated user's and their team's identity, with details varying based on OAuth scopes (e.g., `identity.basic`, `identity.email`, `identity.avatar`).

### Retrieve call information

**Slug:** `SLACK_RETRIEVE_CALL_INFORMATION`

Retrieves a point-in-time snapshot of a specific Slack call's information.

### Retrieve conversation information

**Slug:** `SLACK_RETRIEVE_CONVERSATION_INFORMATION`

Retrieves metadata for a Slack conversation by ID (e.g., name, purpose, creation date, with options for member count/locale), excluding message content; requires a valid channel ID.

### Get conversation members

**Slug:** `SLACK_RETRIEVE_CONVERSATION_MEMBERS_LIST`

Retrieves a paginated list of active member IDs for a specified Slack public channel, private channel, direct message (DM), or multi-person direct message (MPIM).

### Retrieve user DND status

**Slug:** `SLACK_RETRIEVE_CURRENT_USER_DND_STATUS`

Retrieves a Slack user's current Do Not Disturb (DND) status to determine their availability before interaction; any specified user ID must be a valid Slack user ID.

### Retrieve detailed file information

**Slug:** `SLACK_RETRIEVE_DETAILED_INFORMATION_ABOUT_A_FILE`

Retrieves detailed metadata and paginated comments for a specific Slack file ID; does not download file content.

### Retrieve detailed user information

**Slug:** `SLACK_RETRIEVE_DETAILED_USER_INFORMATION`

Retrieves comprehensive information for a valid Slack user ID, excluding message history and channel memberships.

### Retrieve message permalink

**Slug:** `SLACK_RETRIEVE_MESSAGE_PERMALINK_URL`

Retrieves a permalink URL for a specific message in a Slack channel or conversation; the permalink respects Slack's privacy settings.

### Retrieve team profile details

**Slug:** `SLACK_RETRIEVE_TEAM_PROFILE_DETAILS`

Retrieves all profile field definitions for a Slack team, optionally filtered by visibility, to understand the team's profile structure.

### Retrieve user profile information

**Slug:** `SLACK_RETRIEVE_USER_PROFILE_INFORMATION`

Retrieves profile information for a specified Slack user (defaults to the authenticated user if `user` ID is omitted); a provided `user` ID must be valid.

### Revoke a file's public url

**Slug:** `SLACK_REVOKE_PUBLIC_SHARING_ACCESS_FOR_A_FILE`

Revokes a Slack file's public URL, making it private; this is a no-op if not already public and is irreversible.

### Start RTM session

**Slug:** `SLACK_RTM_CONNECT`

Starts a Real Time Messaging session and returns a WebSocket URL. Use when you need to establish a persistent RTM connection to receive real-time events from Slack.

### Start RTM session

**Slug:** `SLACK_RTM_START`

Starts a Real Time Messaging API session for Slack. Use when you need to establish an RTM connection with additional options beyond rtm.connect. Note: RTM API is deprecated; consider Socket Mode for new apps.

### Schedule message

**Slug:** `SLACK_SCHEDULE_MESSAGE`

Schedules a message to a Slack channel, DM, or private group for a future time (`post_at`), requiring `text`, `blocks`, or `attachments` for content; scheduling is limited to 120 days in advance.

### Get SCIM service provider configuration

**Slug:** `SLACK_SCIM_GET_CONFIG`

Tool to retrieve SCIM service provider configuration from Slack. Use when you need to discover Slack's SCIM API capabilities including supported authentication schemes, bulk operations, filtering, and other service provider features.

### Search all content

**Slug:** `SLACK_SEARCH_ALL`

Tool to search all messages and files. Use when you need unified content search across channels and files in one call.

### Search messages

**Slug:** `SLACK_SEARCH_MESSAGES`

Workspace‑wide Slack message search with date ranges and filters. Use `query` modifiers (e.g., in:#channel, from:@user, before/after:YYYY-MM-DD), sorting (score/timestamp), and pagination.

### Send ephemeral message

**Slug:** `SLACK_SEND_EPHEMERAL_MESSAGE`

Sends an ephemeral message to a user in a channel.

### Send message

**Slug:** `SLACK_SEND_MESSAGE`

Posts a message to a Slack channel, direct message, or private group; requires content via `text`, `blocks`, or `attachments`.

### Set a conversation's purpose

**Slug:** `SLACK_SET_A_CONVERSATION_S_PURPOSE`

Sets the purpose (a short description of its topic/goal, displayed in the header) for a Slack conversation; the calling user must be a member.

### Set admin user

**Slug:** `SLACK_SET_ADMIN_USER`

Promotes an existing workspace member (guest, regular user, or owner) to admin status. Use when you need to grant admin privileges to a user.

### Set conversation preferences

**Slug:** `SLACK_SET_CONVERSATION_PREFS`

Sets the posting permissions for a public or private channel in Slack. Use this to control who can post messages, start threads, use @channel/@here mentions, and initiate huddles in a specific channel.

### Set default channels

**Slug:** `SLACK_SET_DEFAULT_CHANNELS`

Tool to set the default channels of a workspace. Use when you need to configure which channels new members automatically join.

### Set DND duration

**Slug:** `SLACK_SET_DND_DURATION`

Turns on Do Not Disturb mode for the current user, or changes its duration.

### Set profile photo

**Slug:** `SLACK_SET_PROFILE_PHOTO`

This method allows the user to set their profile image.

### Set conversation read cursor

**Slug:** `SLACK_SET_READ_CURSOR_IN_A_CONVERSATION`

Marks a message, specified by its timestamp (`ts`), as the most recently read for the authenticated user in the given `channel`, provided the user is a member of the channel and the message exists within it.

### Set Slack user profile information

**Slug:** `SLACK_SET_SLACK_USER_PROFILE_INFORMATION`

Updates a Slack user's profile, setting either individual fields or multiple fields via a JSON object.

### Set Slack Status

**Slug:** `SLACK_SET_STATUS`

Sets the Slack status for the authenticated user with a custom text and optional emoji. The status appears next to the user's name in Slack.

### Set conversation topic

**Slug:** `SLACK_SET_THE_TOPIC_OF_A_CONVERSATION`

Sets or updates the topic for a specified Slack conversation.

### Set workspace description

**Slug:** `SLACK_SET_WORKSPACE_DESCRIPTION`

Set the description of a given workspace. Use when you need to update or change the description text displayed for a Slack workspace.

### Set workspace icon

**Slug:** `SLACK_SET_WORKSPACE_ICON`

Sets the icon of a workspace. Use when you need to update or change the workspace icon image. The image must be publicly accessible and in a supported format (GIF, PNG, JPG, JPEG, HEIC, or HEIF).

### Set workspace name

**Slug:** `SLACK_SET_WORKSPACE_NAME`

Set the name of a given Slack workspace. Use when you need to update the display name for a workspace in an Enterprise Grid organization.

### Set workspace owner

**Slug:** `SLACK_SET_WORKSPACE_OWNER`

Set an existing guest, regular user, or admin user to be a workspace owner. Use when you need to promote a workspace member to owner status.

### Set workspaces for channel

**Slug:** `SLACK_SET_WORKSPACES_FOR_CHANNEL`

Set the workspaces in an Enterprise grid org that connect to a channel. Use when you need to share a public or private channel with specific workspaces in an Enterprise Grid organization.

### Share a me message in a channel

**Slug:** `SLACK_SHARE_A_ME_MESSAGE_IN_A_CHANNEL`

Sends a 'me message' (e.g., '/me is typing') to a Slack channel, where it's displayed as a third-person user action; messages are plain text and the channel must exist and be accessible.

### Share a remote file in channels

**Slug:** `SLACK_SHARE_REMOTE_FILE_IN_CHANNELS`

Shares a remote file, which must already be registered with Slack, into specified Slack channels or direct message conversations.

### Start call

**Slug:** `SLACK_START_CALL`

Registers a new call in Slack using `calls.add` for third-party call integration; `created_by` is required if not using a user-specific token.

### Start real time messaging session

**Slug:** `SLACK_START_REAL_TIME_MESSAGING_SESSION`

Initiates a Slack RTM session providing a single-use WebSocket URL (valid 30s) for event streaming; does not set initial presence status.

### Test authentication

**Slug:** `SLACK_TEST_AUTH`

Checks authentication and tells you who you are. Use to verify Slack API authentication is functional and to retrieve identity information about the authenticated user or bot.

### Unarchive a public or private channel

**Slug:** `SLACK_UNARCHIVE_A_PUBLIC_OR_PRIVATE_CHANNEL`

Unarchives a specified public or private Slack channel that is currently archived, using its channel ID.

### Unarchive channel

**Slug:** `SLACK_UNARCHIVE_CHANNEL`

Reverses conversation archival.

### Unpin message from channel

**Slug:** `SLACK_UNPIN_ITEM_FROM_CHANNEL`

Unpins a message, identified by its timestamp, from a specified channel if the message is currently pinned there; this operation is destructive.

### Update Slack user group

**Slug:** `SLACK_UPDATE_AN_EXISTING_SLACK_USER_GROUP`

Updates an existing Slack User Group, which must be specified by an existing `usergroup` ID, with new optional details such as its name, description, handle, or default channels.

### Update an existing remote file

**Slug:** `SLACK_UPDATES_AN_EXISTING_REMOTE_FILE`

Updates metadata or content details for an existing remote file in Slack; this action cannot upload new files or change the fundamental file type.

### Update a Slack message

**Slug:** `SLACK_UPDATES_A_SLACK_MESSAGE`

Updates a Slack message, identified by `channel` ID and `ts` timestamp, by modifying its `text`, `attachments`, or `blocks`; provide at least one content field, noting `attachments`/`blocks` are replaced if included (`[]` clears them).

### Update call information

**Slug:** `SLACK_UPDATE_SLACK_CALL_INFORMATION`

Updates the title, join URL, or desktop app join URL for an existing Slack call identified by its ID.

### Update user group members

**Slug:** `SLACK_UPDATE_USER_GROUP_MEMBERS`

Replaces all members of an existing Slack User Group with a new list of valid user IDs.

### Upload or create a file in Slack

**Slug:** `SLACK_UPLOAD_OR_CREATE_A_FILE_IN_SLACK`

Upload files, images, screenshots, documents, or any media to Slack channels or threads. Supports all file types including images (PNG, JPG, JPEG, GIF), documents (PDF, DOCX, TXT), code files, and more. Can share files publicly in channels or as thread replies with optional comments.

### Mark user as active

**Slug:** `SLACK_USERS_SET_ACTIVE`

Tool to mark a user as active in Slack. Note: This endpoint is deprecated and non-functional - it exists for backwards compatibility but does not perform any action.


## Triggers

### New Channel Created Trigger

**Slug:** `SLACK_CHANNEL_CREATED`

Triggered when a new channel is created in Slack.

### Reaction Added Trigger

**Slug:** `SLACK_REACTION_ADDED`

Triggered when a reaction is added to a message in Slack.

### Reaction Removed Trigger

**Slug:** `SLACK_REACTION_REMOVED`

Triggered when a reaction is removed from a message.

### New Bot Message Received Trigger

**Slug:** `SLACK_RECEIVE_BOT_MESSAGE`

Triggered when a new bot message is posted to a Slack channel.

### New Direct Message Received Trigger

**Slug:** `SLACK_RECEIVE_DIRECT_MESSAGE`

Triggered when a new direct message (DM) is sent to a user in Slack.

### New Private Channel Message Received Trigger

**Slug:** `SLACK_RECEIVE_GROUP_MESSAGE`

Triggered when a new message is posted to a private channel in Slack.

### New Message Received Trigger

**Slug:** `SLACK_RECEIVE_MESSAGE`

Triggered when a new message is posted to a Slack channel.

### New Multi-Person Direct Message Received Trigger

**Slug:** `SLACK_RECEIVE_MPIM_MESSAGE`

Triggered when a new message is posted to a multi-person direct message in Slack.

### Thread Reply Received Trigger

**Slug:** `SLACK_RECEIVE_THREAD_REPLY`

Triggered when reply is added to a message in a thread.
    Excludes the parent message_replied event by design (ts != thread_ts check).
