Web API methods

admin.analytics.getFileRetrieve analytics data for a given date, presented as a compressed JSON file
admin.apps.approveApprove an app for installation on a workspace.
admin.apps.clearResolutionClear an app resolution
admin.apps.restrictRestrict an app for installation on a workspace.
admin.apps.uninstallUninstall an app from one or many workspaces, or an entire enterprise organization.
admin.apps.approved.listList approved apps for an org or workspace.
admin.apps.requests.cancelCancel app request for team
admin.apps.requests.listList app requests for a team/workspace.
admin.apps.restricted.listList restricted apps for an org or workspace.
admin.audit.anomaly.allow.getItemAPI to allow enterprise grid admins to read the allow list of IP blocks and ASNs from the enterprise configuration.
admin.audit.anomaly.allow.updateItemAPI to allow enterprise grid admins to write/overwrite the allow list of IP blocks and ASNs from the enterprise configuration.
admin.auth.policy.assignEntitiesAssign entities to a particular authentication policy.
admin.auth.policy.getEntitiesFetch all the entities assigned to a particular authentication policy by name.
admin.auth.policy.removeEntitiesRemove specified entities from a specified authentication policy.
admin.barriers.createCreate an Information Barrier
admin.barriers.deleteDelete an existing Information Barrier
admin.barriers.listGet all Information Barriers for your organization
admin.barriers.updateUpdate an existing Information Barrier
admin.conversations.archiveArchive a public or private channel.
admin.conversations.bulkArchiveArchive public or private channels in bulk.
admin.conversations.bulkDeleteDelete public or private channels in bulk
admin.conversations.bulkMoveMove public or private channels in bulk.
admin.conversations.convertToPrivateConvert a public channel to a private channel.
admin.conversations.convertToPublicConvert a private channel to a public channel.
admin.conversations.createCreate a public or private channel-based conversation.
admin.conversations.deleteDelete a public or private channel.
admin.conversations.disconnectSharedDisconnect a connected channel from one or more workspaces.
admin.conversations.getConversationPrefsGet conversation preferences for a public or private channel.
admin.conversations.getCustomRetentionThis API endpoint can be used by any admin to get a conversation's retention policy.
admin.conversations.getTeamsGet all the workspaces a given public or private channel is connected to within this Enterprise org.
admin.conversations.inviteInvite a user to a public or private channel.
admin.conversations.lookupReturns channels on the given team using the filters.
admin.conversations.removeCustomRetentionThis API endpoint can be used by any admin to remove a conversation's retention policy.
admin.conversations.renameRename a public or private channel.
admin.conversations.searchSearch for public or private channels in an Enterprise organization.
admin.conversations.setConversationPrefsSet the posting permissions for a public or private channel.
admin.conversations.setCustomRetentionThis API endpoint can be used by any admin to set a conversation's retention policy.
admin.conversations.setTeamsSet the workspaces in an Enterprise grid org that connect to a public or private channel.
admin.conversations.unarchiveUnarchive a public or private channel.
admin.conversations.ekm.listOriginalConnectedChannelInfoList all disconnected channels—i.e., channels that were once connected to other workspaces and then disconnected—and the corresponding original channel IDs for key revocation with EKM.
admin.conversations.restrictAccess.addGroupAdd an allowlist of IDP groups for accessing a channel
admin.conversations.restrictAccess.listGroupsList all IDP Groups linked to a channel
admin.conversations.restrictAccess.removeGroupRemove a linked IDP group linked from a private channel
admin.emoji.addAdd an emoji.
admin.emoji.addAliasAdd an emoji alias.
admin.emoji.listList emoji for an Enterprise Grid organization.
admin.emoji.removeRemove an emoji across an Enterprise Grid organization
admin.emoji.renameRename an emoji.
admin.inviteRequests.approveApprove a workspace invite request.
admin.inviteRequests.denyDeny a workspace invite request.
admin.inviteRequests.listList all pending workspace invite requests.
admin.inviteRequests.approved.listList all approved workspace invite requests.
admin.inviteRequests.denied.listList all denied workspace invite requests.
admin.roles.addAssignmentsAdds members to the specified role with the specified scopes
admin.roles.listAssignmentsLists assignments for all roles across entities. Options to scope results by any combination of roles or entities
admin.roles.removeAssignmentsRemoves a set of users from a role for the given scopes and entities
admin.teams.admins.listList all of the admins on a given workspace.
admin.teams.createCreate an Enterprise team.
admin.teams.listList all teams on an Enterprise organization
admin.teams.owners.listList all of the owners on a given workspace.
admin.teams.settings.infoFetch information about settings in a workspace
admin.teams.settings.setDefaultChannelsSet the default channels of a workspace.
admin.teams.settings.setDescriptionSet the description of a given workspace.
admin.teams.settings.setDiscoverabilityAn API method that allows admins to set the discoverability of a given workspace
admin.teams.settings.setIconSets the icon of a workspace.
admin.teams.settings.setNameSet the name of a given workspace.
admin.usergroups.addChannelsAdd up to one hundred default channels to an IDP group.
admin.usergroups.addTeamsAssociate one or more default workspaces with an organization-wide IDP group.
admin.usergroups.listChannelsList the channels linked to an org-level IDP group (user group).
admin.usergroups.removeChannelsRemove one or more default channels from an org-level IDP group (user group).
admin.users.assignAdd an Enterprise user to a workspace.
admin.users.inviteInvite a user to a workspace.
admin.users.listList users on a workspace
admin.users.removeRemove a user from a workspace.
admin.users.setAdminSet an existing guest, regular user, or owner to be an admin user.
admin.users.setExpirationSet an expiration for a guest user
admin.users.setOwnerSet an existing guest, regular user, or admin user to be a workspace owner.
admin.users.setRegularSet an existing guest user, admin user, or owner to be a regular user.
admin.users.session.clearSettingsClear user-specific session settings—the session duration and what happens when the client closes—for a list of users.
admin.users.session.getSettingsGet user-specific session settings—the session duration and what happens when the client closes—given a list of users.
admin.users.session.invalidateRevoke a single session for a user. The user will be forced to login to Slack.
admin.users.session.listList active user sessions for an organization
admin.users.session.resetWipes all valid sessions on all devices for a given user
admin.users.session.resetBulkEnqueues an asynchronous job to wipe all valid sessions on all devices for a given list of users
admin.users.session.setSettingsConfigure the user-level session settings—the session duration and what happens when the client closes—for one or more users.
admin.users.unsupportedVersions.exportAsk Slackbot to send you an export listing all workspace members using unsupported software, presented as a zipped CSV file.
api.testChecks API calling code.
apps.auth.external.deleteDelete external auth tokens only on the Slack side
apps.auth.external.getGet the access token for the provided token ID
apps.connections.openGenerate a temporary Socket Mode WebSocket URL that your app can connect to in order to receive events and interactive payloads over.
apps.datastore.deleteDelete an item from a datastore
apps.datastore.getGet an item from a datastore
apps.datastore.putCreates a new item, or replaces an old item with a new item.
apps.datastore.queryQuery a datastore for items
apps.datastore.updateEdits an existing item's attributes, or adds a new item if it does not already exist.
apps.event.authorizations.listGet a list of authorizations for the given event context. Each authorization represents an app installation that the event is visible to.
apps.manifest.createCreate an app from an app manifest.
apps.manifest.deletePermanently deletes an app created through app manifests
apps.manifest.exportExport an app manifest from an existing app
apps.manifest.updateUpdate an app from an app manifest
apps.manifest.validateValidate an app manifest
apps.uninstallUninstalls your app from a workspace.
auth.revokeRevokes a token.
auth.testChecks authentication & identity.
auth.teams.listList the workspaces a token can access.
bookmarks.addAdd bookmark to a channel.
bookmarks.editEdit bookmark.
bookmarks.listList bookmark for the channel.
bookmarks.removeRemove bookmark from the channel.
bots.infoGets information about a bot user.
calls.addRegisters a new Call.
calls.endEnds a Call.
calls.infoReturns information about a Call.
calls.updateUpdates information about a Call.
calls.participants.addRegisters new participants added to a Call.
calls.participants.removeRegisters participants removed from a Call.
chat.deleteDeletes a message.
chat.deleteScheduledMessageDeletes a pending scheduled message from the queue.
chat.getPermalinkRetrieve a permalink URL for a specific extant message
chat.meMessageShare a me message into a channel.
chat.postEphemeralSends an ephemeral message to a user in a channel.
chat.postMessageSends a message to a channel.
chat.scheduleMessageSchedules a message to be sent to a channel.
chat.unfurlProvide custom unfurl behavior for user-posted URLs
chat.updateUpdates a message.
chat.scheduledMessages.listReturns a list of scheduled messages.
conversations.acceptSharedInviteAccepts an invitation to a Slack Connect channel.
conversations.approveSharedInviteApproves an invitation to a Slack Connect channel
conversations.archiveArchives a conversation.
conversations.closeCloses a direct message or multi-person direct message.
conversations.createInitiates a public or private channel-based conversation
conversations.declineSharedInviteDeclines a Slack Connect channel invite.
conversations.historyFetches a conversation's history of messages and events.
conversations.infoRetrieve information about a conversation.
conversations.inviteInvites users to a channel.
conversations.inviteSharedSends an invitation to a Slack Connect channel
conversations.joinJoins an existing conversation.
conversations.kickRemoves a user from a conversation.
conversations.leaveLeaves a conversation.
conversations.listLists all channels in a Slack team.
conversations.listConnectInvitesLists shared channel invites that have been generated or received but have not been approved by all parties
conversations.markSets the read cursor in a channel.
conversations.membersRetrieve members of a conversation.
conversations.openOpens or resumes a direct message or multi-person direct message.
conversations.renameRenames a conversation.
conversations.repliesRetrieve a thread of messages posted to a conversation
conversations.setPurposeSets the purpose for a conversation.
conversations.setTopicSets the topic for a conversation.
conversations.unarchiveReverses conversation archival.
dialog.openOpen a dialog with a user
dnd.endDndEnds the current user's Do Not Disturb session immediately.
dnd.endSnoozeEnds the current user's snooze mode immediately.
dnd.infoRetrieves a user's current Do Not Disturb status.
dnd.setSnoozeTurns on Do Not Disturb mode for the current user, or changes its duration.
dnd.teamInfoRetrieves the Do Not Disturb status for up to 50 users on a team.
emoji.listLists custom emoji for a team.
files.comments.deleteDeletes an existing comment on a file.
files.completeUploadExternalFinishes an upload started with files.getUploadURLExternal
files.deleteDeletes a file.
files.getUploadURLExternalGets a URL for an edge external file upload
files.infoGets information about a file.
files.listList for a team, in a channel, or from a user with applied filters.
files.revokePublicURLRevokes public/external sharing access for a file
files.sharedPublicURLEnables a file for public/external sharing.
files.uploadUploads or creates a file.
files.remote.addAdds a file from a remote service
files.remote.infoRetrieve information about a remote file added to Slack
files.remote.listRetrieve information about a remote file added to Slack
files.remote.removeRemove a remote file.
files.remote.shareShare a remote file into a channel.
files.remote.updateUpdates an existing remote file.
functions.workflows.steps.listList the steps of a specific function of a workflow's versions
functions.workflows.steps.responses.exportDownload form responses of a workflow
migration.exchangeFor Enterprise Grid workspaces, map local user IDs to global user IDs
oauth.accessExchanges a temporary OAuth verifier code for an access token.
oauth.v2.accessExchanges a temporary OAuth verifier code for an access token.
oauth.v2.exchangeExchanges a legacy access token for a new expiring access token and refresh token
openid.connect.tokenExchanges a temporary OAuth verifier code for an access token for Sign in with Slack.
openid.connect.userInfoGet the identity of a user who has authorized Sign in with Slack.
pins.addPins an item to a channel.
pins.listLists items pinned to a channel.
pins.removeUn-pins an item from a channel.
reactions.addAdds a reaction to an item.
reactions.getGets reactions for an item.
reactions.listLists reactions made by a user.
reactions.removeRemoves a reaction from an item.
reminders.addCreates a reminder.
reminders.completeMarks a reminder as complete.
reminders.deleteDeletes a reminder.
reminders.infoGets information about a reminder.
reminders.listLists all reminders created by or for a given user.
rtm.connectStarts a Real Time Messaging session.
rtm.startDeprecated: Starts a Real Time Messaging session. Use rtm.connect instead.
search.allSearches for messages and files matching a query.
search.filesSearches for files matching a query.
search.messagesSearches for messages matching a query.
stars.addSave an item for later. Formerly known as _adding a star_.
stars.listList a user's saved items, formerly known as stars.
stars.removeRemoves a saved item (star) from an item.
team.accessLogsGets the access logs for the current team.
team.billableInfoGets billable users information for the current team.
team.infoGets information about the current team.
team.integrationLogsGets the integration logs for the current team.
team.billing.infoReads a workspace's billing plan information.
team.preferences.listRetrieve a list of a workspace's team preferences.
team.profile.getRetrieve a team's profile.
tooling.tokens.rotateExchanges a refresh token for a new app configuration token.
usergroups.createCreate a User Group
usergroups.disableDisable an existing User Group
usergroups.enableEnable a User Group
usergroups.listList all User Groups for a team
usergroups.updateUpdate an existing User Group
usergroups.users.listList all users in a User Group
usergroups.users.updateUpdate the list of users for a User Group
users.conversationsList conversations the calling user may access.
users.deletePhotoDelete the user profile photo
users.getPresenceGets user presence information.
users.identityGet a user's identity.
users.infoGets information about a user.
users.listLists all users in a Slack team.
users.lookupByEmailFind a user with an email address.
users.setActiveMarked a user as active. Deprecated and non-functional.
users.setPhotoSet the user profile photo
users.setPresenceManually sets user presence.
users.profile.getRetrieve a user's profile information, including their custom status.
users.profile.setSet a user's profile information, including custom status.
views.openOpen a view for a user.
views.publishPublish a static view for a User.
views.pushPush a view onto the stack of a root view.
views.updateUpdate an existing view.
workflows.stepCompletedIndicate that an app's step in a workflow completed execution.
workflows.stepFailedIndicate that an app's step in a workflow failed to execute.
workflows.updateStepUpdate the configuration for a workflow step.
channels.createCreates a channel.Deprecated
channels.infoGets information about a channel.Deprecated
channels.inviteInvites a user to a channel.Deprecated
channels.markSets the read cursor in a channel.Deprecated
groups.createCreates a private channel.Deprecated
groups.infoGets information about a private channel.Deprecated
groups.inviteInvites a user to a private channel.Deprecated
groups.markSets the read cursor in a private channel.Deprecated
groups.openOpens a private channel.Deprecated
im.listLists direct message channels for the calling user.Deprecated
im.markSets the read cursor in a direct message channel.Deprecated
im.openOpens a direct message channel.Deprecated
mpim.listLists multiparty direct message channels for the calling user.Deprecated
mpim.markSets the read cursor in a multiparty direct message channel.Deprecated
mpim.openThis method opens a multiparty direct message.Deprecated

Usage guides

Easily access APIs with Bolt

Make API calls, and handle responses, with a couple of lines of code, using our Bolt framework.

Using the Web API

If you can't use Bolt, read our guide to hand-craft Web API usage into your app.