Slack

Sets or updates the do not disturb (dnd) snooze duration in minutes for the authenticated user, pausing notifications immediately for the specified time.

Adds an alias for an existing custom emoji in a slack enterprise grid organization.

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

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.

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

Adds channels to an idp user group's list of default channels, meaning new group members are automatically added to them; these channels supplement, and do not replace, any existing defaults.

Assigns an existing enterprise user, not already in the target workspace, to a specific slack workspace within an enterprise grid organization, optionally adding them to channels and defining their guest status.

Restricts access to a private slack channel to members of a specified idp group by linking the group to the channel's allowlist within an enterprise grid organization; `team id` is required for single-workspace channels, otherwise optional.

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

Approves a pending app installation request within a slack workspace; requires admin privileges.

Approves an existing, pending invite request for a slack workspace; this action is irreversible.

Deprecated: retrieves permissions for the app; use `list app permissions on a team` instead.

Deprecated: use 'list app permissions scopes on a team' instead; retrieves oauth scopes for the authenticated slack app.

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

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.

Associates specified slack workspaces (teams) with an existing idp user group as its default workspaces, requiring all workspaces and the group to be within the same organization.

Deprecated: posts a message to a slack channel, direct message, or private channel. use `sends a message to a slack channel` instead.<<DEPRECATED use sends_a_message_to_a_slack_channel>>

Calls slack's `api.test` method to check api status, optionally specifying an error to trigger or an arbitrary parameter to echo.

Use to validate the current authentication token and get basic identity (user/bot, team) information; it does not return token scopes.

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.

Deprecated: use `fetch conversation history`. retrieves message history from a slack conversation accessible by the authenticated user/bot, with pagination and time filtering.

Deprecated (use `retrieve conversation information`): retrieves metadata (name, purpose, creation date) for a slack conversation, excluding messages.

(deprecated) retrieves public channels, private channels, mpims, and ims from a slack workspace; use `list all slack team channels with various filters` instead.

Converts a public channel to private; this is irreversible and the channel must already exist.

Creates a new team within a slack enterprise grid organization; the organization must be on an enterprise grid plan.

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').

Creates a new user group (often referred to as a subteam) in a slack workspace.

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).

Customizes url previews (unfurling) in a specific slack message using a url-encoded json in `unfurls` to define custom content or remove existing previews.

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.

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

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.

Permanently and irreversibly deletes a specified public or private channel, including all its messages and files, within a slack enterprise grid organization.

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

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

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.

Denies a pending slack workspace invite request that is currently active; this action is irreversible.

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.

Disconnects a shared channel within a slack enterprise grid from specified, currently connected, workspace(s), permanently altering its sharing settings; not applicable to dms.

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.

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

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

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.

Immediately ends the user's active do not disturb (dnd) snooze in slack, allowing them to resume receiving notifications.

Exchanges a temporary, single-use slack oauth `code` for an access token; used in the oauth flow and does not require a pre-existing api token.

Exchanges a temporary slack authorization code, obtained via oauth callback, for a workspace access token.

Call this action to complete the slack oauth 2.0 flow by exchanging a temporary authorization `code` and client credentials for an access token, providing the original `redirect uri` if it was used in the initial authorization step.

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

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.

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

Fetches the do not disturb (dnd) status for a comma-separated list of specified slack user ids.

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

Retrieves replies to a specific parent message in a slack conversation, using the channel id and the parent message's timestamp (`ts`).

Retrieves detailed settings for a specific slack workspace, primarily for administrators in an enterprise grid organization to view or audit workspace configurations.

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.

Retrieves billable status (not amounts or settings) for users in a slack team; only provides meaningful data if billing features are active on the workspace.

Retrieves conversation preferences (e.g., who can post, who can thread) for a specified channel, primarily for use within slack enterprise grid environments.

For slack enterprise grid, retrieves workspace ids connected to a given channel, typically for administrators to audit multi-workspace channel access.

Fetches potentially delayed integration activity logs for the current slack team, filterable by app, change type, service, or user, to audit integration activities.

Retrieves paginated access logs for the current slack team, detailing user login events for security auditing and monitoring workspace access, typically requiring admin privileges and a supporting slack plan.

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

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.

Signals to slack that an identified workflow step (`workflow step execute id`) of an active custom workflow has failed, providing an error message; this action only reports the failure and does not attempt to retry or resolve it.

Creates a new, uniquely named public or private channel in slack.

Forcibly terminates a specific user's active slack session, identified by `session id` within the specified `team id`, mainly for administrative security needs like immediate access revocation when other methods are inadequate.

Invites users to an existing slack channel using their valid slack user ids.

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.

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.

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

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.

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

Lists all authenticated user's starred items (messages, files, comments, channels, dms, groups) in slack, with pagination.

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

Retrieves public channels, private channels, multi-person direct messages (mpims), and direct messages (ims) from a slack workspace, with options to filter by type and exclude archived channels.

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.

Lists all teams (workspaces) within a slack enterprise grid organization for auditing, management, or reporting.

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

Fetches a paginated list of approved applications for a slack workspace (using `team id`) or an enterprise grid organization (using `enterprise id`); if neither id is specified, the scope depends on the authentication context.

Lists approved invite requests for a slack workspace; if `team id` is omitted, requests are listed based on the token's default scope or primary workspace.

Retrieves a list of permissions and resources granted to the slack application associated with the token.

Retrieves all oauth scopes (bot and user token) granted to the authenticated slack app on the current team.

Lists resources (e.g., channels, users) the authenticated slack app can access in the workspace, noting the list is filtered by the app's current authentication scopes.

Lists oauth grants and scopes users on a slack team approved for the calling application.

Retrieves a list of all invite requests that have been *denied* for a slack workspace, primarily for auditing or reviewing past access decisions.

Lists original connected channel information for specified enterprise key management (ekm) enabled channels, particularly disconnected or frozen ones, within an ekm-enabled slack workspace.

Retrieves a paginated list of all user-created custom emojis for a slack enterprise grid organization.

Lists app installations authorized for a given slack event context, to determine app visibility for that event.

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

Lists identity provider (idp) group ids linked to a private slack channel; `team id` is required if the channel is not organization-wide.

Lists channels linked to an identity provider (idp) user group, optionally for a specific team if the token accesses multiple teams in an enterprise grid.

Retrieves a list of all pending invite requests for a slack workspace, primarily for administrators to manage outstanding invitations.

Lists applications restricted from installation within a specific slack workspace (using `team id`) or an entire enterprise grid organization (using `enterprise id`).

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.

Lists metadata (not content) for remote files shared in a slack workspace, with support for filtering and pagination.

Retrieves all custom emojis for the slack workspace (image urls or aliases), not standard unicode emojis; does not include usage statistics or creation dates.

Retrieves a list of app installation requests for a slack workspace or enterprise grid organization.

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

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.

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

Lists all administrator user ids for a given slack workspace (team id), which must be part of an enterprise grid organization.

Lists the owners of a specific slack workspace (team id) that is part of an enterprise grid organization.

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

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).

Converts slack user ids between workspace-specific (e.g., u12345) and global enterprise grid (e.g., wabcdef) formats; defaults to converting 'u' ids to 'w' ids, set `to old=true` to convert 'w' ids to 'u' ids.

Deprecated: marks the authenticated user as active, typically when they return from inactivity.

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.

Marks an active slack workflow step as completed via its `workflow step execute id` when its execution has successfully concluded, optionally providing json outputs for subsequent steps; this action only updates the step's status and does not execute the step itself.

Opens a modal view for a slack user in response to an interaction.

Opens or resumes a slack direct message (dm) or multi-person direct message (mpim) by providing either user ids or an existing channel id.

Opens an interactive slack dialog modal to collect user information or display complex content, defined by a valid slack `dialog` json, using a `trigger id` from a recent user interaction (valid for only 3 seconds).

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

Promotes a user to an admin in a slack enterprise grid workspace, provided the user is not the primary owner.

Promotes a user to a workspace owner within a slack enterprise grid organization; this action is irreversible through the api.

Publishes or updates the home tab view for a specified user in slack; this cannot be used for modals or messages.

Pushes a new view onto an existing view stack in a slack modal or home tab for dynamic multi-step interactions; view stack depth is limited (e.g., typically 3 for modals).

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.

Adds new participants (specified in `users` json with `slack id`/`external id`) to an ongoing slack call identified by its `id` (from `calls.add`).

Removes specified participants from an active slack call; removal is irreversible and the call persists even if empty.

Deprecated: creates a slack reminder; use `create a reminder` instead.

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.

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).

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

Disassociates channels from an idp group; this action does not delete the channels or the group itself and may affect user access.

Removes an existing custom emoji, specified by its name, from a slack enterprise grid organization, rendering it unavailable across all associated workspaces; this action is permanent and cannot be undone.

Unlinks an already-linked identity provider (idp) group from a private slack channel to revoke its members' access; specify `team id` if the channel is not shared across an organization.

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

Irreversibly removes a user from a slack workspace, permanently revoking their access; back up user data beforehand if needed as this action does not preserve it.

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

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.

Renames a public or private slack channel; for enterprise grid workspaces, the user must be a workspace admin or channel manager.

Requests additional oauth `scopes` for a slack app, initiating an approval process with workspace administrators rather than granting permissions directly; requires a `trigger id` from a recent user interaction.

Restricts an app (using `app id` and `team id`) or a pending app installation request (using `request id`) in a slack workspace.

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`).

Retrieves a point-in-time snapshot of a specific slack call's 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.

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).

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.

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

Retrieves comprehensive information for a valid slack user id, excluding message history and channel memberships.

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