Skip to main content

Class: WebClient

Defined in: packages/web-api/src/WebClient.ts:191

A client for Slack's Web API

This client provides an alias for each API method. Each method is a convenience wrapper for calling the WebClient#apiCall method using the method name as the first parameter.

Extends

Constructors

new WebClient()

new WebClient(token?, webClientOptions?): WebClient

Defined in: packages/web-api/src/WebClient.ts:265

Parameters

token?

string

An API token to authenticate/authorize with Slack (usually start with xoxp, xoxb)

webClientOptions?

WebClientOptions = {}

Configuration options.

Returns

WebClient

Overrides

Methods.constructor

Properties

admin

readonly admin: object;

Defined in: packages/web-api/src/methods.ts:570

analytics

analytics: object;
analytics.getFile
getFile: MethodWithRequiredArgument<AdminAnalyticsGetFileArguments, AdminAnalyticsGetFileResponse>;
Description

Retrieve analytics data for a given date, presented as a compressed JSON file.

See

`api.test` API reference.

apps

apps: object;
apps.activities
activities: object;
apps.activities.list
list: Method<Partial<AppID> & Partial<TeamID> & TokenOverridable & CursorPaginationEnabled & object, AdminAppsActivitiesListResponse>;
Description

Get logs for a specified team/org.

See

`admin.apps.activities.list` API reference.

apps.approve
approve: MethodWithRequiredArgument<AdminAppsApproveArguments, AdminAppsApproveResponse>;
Description

Approve an app for installation on a workspace.

See

`admin.apps.approve` API reference.

apps.approved
approved: object;
apps.approved.list
list: MethodWithRequiredArgument<AdminAppsApprovedListArguments, AdminAppsApprovedListResponse>;
Description

List approved apps for an org or workspace.

See

`admin.apps.approved.list` API reference.

apps.clearResolution
clearResolution: MethodWithRequiredArgument<AdminAppsClearResolutionArguments, AdminAppsClearResolutionResponse>;
Description

Clear an app resolution.

See

`admin.apps.clearResolution` API reference.

apps.config
config: object;
apps.config.lookup
lookup: MethodWithRequiredArgument<AdminAppsConfigLookupArguments, AdminAppsConfigLookupResponse>;
Description

Look up the app config for connectors by their IDs.

See

`admin.apps.config.lookup` API reference.

apps.config.set
set: MethodWithRequiredArgument<AdminAppsConfigSetArguments, AdminAppsConfigSetResponse>;
Description

Set the app config for a connector.

See

`admin.apps.config.set` API reference.

apps.requests
requests: object;
apps.requests.cancel
cancel: MethodWithRequiredArgument<AdminAppsRequestsCancelArguments, AdminAppsRequestsCancelResponse>;
Description

Cancel app request for team.

See

`admin.apps.requests.cancel` API reference.

apps.requests.list
list: MethodWithRequiredArgument<AdminAppsRequestsListArguments, AdminAppsRequestsListResponse>;
Description

List app requests for a team/workspace.

See

`admin.apps.requests.list` API reference.

apps.restrict
restrict: MethodWithRequiredArgument<AdminAppsRestrictArguments, AdminAppsRestrictResponse>;
Description

Restrict an app for installation on a workspace.

See

`admin.apps.restrict` API reference.

apps.restricted
restricted: object;
apps.restricted.list
list: MethodWithRequiredArgument<AdminAppsRestrictedListArguments, AdminAppsRestrictedListResponse>;
Description

List restricted apps for an org or workspace.

See

`admin.apps.restricted.list` API reference.

apps.uninstall
uninstall: MethodWithRequiredArgument<AdminAppsUninstallArguments, AdminAppsUninstallResponse>;
Description

Uninstall an app from one or many workspaces, or an entire enterprise organization.

See

`admin.apps.uninstall` API reference.

auth

auth: object;
auth.policy
policy: object;
auth.policy.assignEntities
assignEntities: MethodWithRequiredArgument<AdminAuthPolicyAssignEntitiesArguments, AdminAuthPolicyAssignEntitiesResponse>;
Description

Assign entities to a particular authentication policy.

See

`admin.auth.policy.assignEntities` API reference.

auth.policy.getEntities
getEntities: MethodWithRequiredArgument<AdminAuthPolicyGetEntitiesArguments, AdminAuthPolicyGetEntitiesResponse>;
Description

Fetch all the entities assigned to a particular authentication policy by name.

See

`admin.auth.policy.getEntities` API reference.

auth.policy.removeEntities
removeEntities: MethodWithRequiredArgument<AdminAuthPolicyRemoveEntitiesArguments, AdminAuthPolicyRemoveEntitiesResponse>;
Description

Remove specified entities from a specified authentication policy.

See

`admin.auth.policy.removeEntities` API reference.

barriers

barriers: object;
barriers.create
create: MethodWithRequiredArgument<AdminBarriersCreateArguments, AdminBarriersCreateResponse>;
Description

Create an Information Barrier.

See

`admin.barriers.create` API reference.

barriers.delete
delete: MethodWithRequiredArgument<AdminBarriersDeleteArguments, AdminBarriersDeleteResponse>;
Description

Delete an existing Information Barrier.

See

`admin.barriers.delete` API reference.

barriers.list
list: Method<TokenOverridable & CursorPaginationEnabled, AdminBarriersListResponse>;
Description

Get all Information Barriers for your organization.

See

`admin.barriers.list` API reference.

barriers.update
update: MethodWithRequiredArgument<AdminBarriersUpdateArguments, AdminBarriersUpdateResponse>;
Description

Update an existing Information Barrier.

See

`admin.barriers.update` API reference.

conversations

conversations: object;
conversations.archive
archive: MethodWithRequiredArgument<AdminConversationsArchiveArguments, AdminConversationsArchiveResponse>;
Description

Archive a public or private channel.

See

`admin.conversations.archive` API reference.

conversations.bulkArchive
bulkArchive: MethodWithRequiredArgument<AdminConversationsBulkArchiveArguments, AdminConversationsBulkArchiveResponse>;
Description

Archive public or private channels in bulk.

See

`admin.conversations.bulkArchive` API reference.

conversations.bulkDelete
bulkDelete: MethodWithRequiredArgument<AdminConversationsBulkDeleteArguments, AdminConversationsBulkDeleteResponse>;
Description

Delete public or private channels in bulk.

See

`admin.conversations.bulkDelete` API reference.

conversations.bulkMove
bulkMove: MethodWithRequiredArgument<AdminConversationsBulkMoveArguments, AdminConversationsBulkMoveResponse>;
Description

Move public or private channels in bulk.

See

`admin.conversations.bulkMove` API reference.

conversations.convertToPrivate
convertToPrivate: MethodWithRequiredArgument<AdminConversationsConvertToPrivateArguments, AdminConversationsConvertToPrivateResponse>;
Description

Convert a public channel to a private channel.

See

`admin.conversations.convertToPrivate` API reference.

conversations.convertToPublic
convertToPublic: MethodWithRequiredArgument<AdminConversationsConvertToPublicArguments, AdminConversationsConvertToPublicResponse>;
Description

Convert a private channel to a public channel.

See

`admin.conversations.convertToPublic` API reference.

conversations.create
create: MethodWithRequiredArgument<AdminConversationsCreateArguments, AdminConversationsCreateResponse>;
Description

Create a public or private channel-based conversation.

See

`admin.conversations.create` API reference.

conversations.delete
delete: MethodWithRequiredArgument<AdminConversationsDeleteArguments, AdminConversationsDeleteResponse>;
Description

Delete a public or private channel.

See

`admin.conversations.delete` API reference.

conversations.disconnectShared
disconnectShared: MethodWithRequiredArgument<AdminConversationsDisconnectSharedArguments, AdminConversationsDisconnectSharedResponse>;
Description

Disconnect a connected channel from one or more workspaces.

See

`admin.conversations.disconnectShared` API reference.

conversations.ekm
ekm: object;
conversations.ekm.listOriginalConnectedChannelInfo
listOriginalConnectedChannelInfo: Method<Partial<TeamIDs> & TokenOverridable & CursorPaginationEnabled & Partial<ChannelIDs>, AdminConversationsEkmListOriginalConnectedChannelInfoResponse>;
Description

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

See

`admin.conversations.ekm.listOriginalConnectedChannelInfo` API reference.

conversations.getConversationPrefs
getConversationPrefs: MethodWithRequiredArgument<AdminConversationsGetConversationPrefsArguments, AdminConversationsGetConversationPrefsResponse>;
Description

Get conversation preferences for a public or private channel.

See

`admin.conversations.getConversationPrefs` API reference.

conversations.getCustomRetention
getCustomRetention: MethodWithRequiredArgument<AdminConversationsGetCustomRetentionArguments, AdminConversationsGetCustomRetentionResponse>;
Description

Get a conversation's retention policy.

See

`admin.conversations.getCustomRetention` API reference.

conversations.getTeams
getTeams: MethodWithRequiredArgument<AdminConversationsGetTeamsArguments, AdminConversationsGetTeamsResponse>;
Description

Get all the workspaces a given public or private channel is connected to within this Enterprise org.

See

`admin.conversations.getTeams` API reference.

conversations.invite
invite: MethodWithRequiredArgument<AdminConversationsInviteArguments, AdminConversationsInviteResponse>;
Description

Invite a user to a public or private channel.

See

`admin.conversations.invite` API reference.

conversations.lookup
lookup: MethodWithRequiredArgument<AdminConversationsLookupArguments, AdminConversationsLookupResponse>;
Description

Returns channels on the given team using the filters.

See

`admin.conversations.lookup` API reference.

conversations.removeCustomRetention
removeCustomRetention: MethodWithRequiredArgument<AdminConversationsRemoveCustomRetentionArguments, AdminConversationsRemoveCustomRetentionResponse>;
Description

Remove a conversation's retention policy.

See

`admin.conversations.removeCustomRetention` API reference.

conversations.rename
rename: MethodWithRequiredArgument<AdminConversationsRenameArguments, AdminConversationsRenameResponse>;
Description

Rename a public or private channel.

See

`admin.conversations.rename` API reference.

conversations.restrictAccess
restrictAccess: object;
conversations.restrictAccess.addGroup
addGroup: MethodWithRequiredArgument<AdminConversationsRestrictAccessAddGroupArguments, AdminConversationsRestrictAccessAddGroupResponse>;
Description

Add an allowlist of IDP groups for accessing a channel.

See

`admin.conversations.restrictAccess.addGroup` API reference.

conversations.restrictAccess.listGroups
listGroups: MethodWithRequiredArgument<AdminConversationsRestrictAccessListGroupsArguments, AdminConversationsRestrictAccessListGroupsResponse>;
Description

List all IDP Groups linked to a channel.

See

`admin.conversations.restrictAccess.listGroups` API reference.

conversations.restrictAccess.removeGroup
removeGroup: MethodWithRequiredArgument<AdminConversationsRestrictAccessRemoveGroupArguments, AdminConversationsRestrictAccessRemoveGroupResponse>;
Description

Remove a linked IDP group linked from a private channel.

See

`admin.conversations.restrictAccess.removeGroup` API reference.

conversations.search
search: Method<SortDir & Partial<TeamIDs> & TokenOverridable & CursorPaginationEnabled & object, AdminConversationsSearchResponse>;
Description

Search for public or private channels in an Enterprise organization.

See

`admin.conversations.search` API reference.

conversations.setConversationPrefs
setConversationPrefs: MethodWithRequiredArgument<AdminConversationsSetConversationPrefsArguments, AdminConversationsSetConversationPrefsResponse>;
Description

Set the posting permissions for a public or private channel.

See

`admin.conversations.setConversationPrefs` API reference.

conversations.setCustomRetention
setCustomRetention: MethodWithRequiredArgument<AdminConversationsSetCustomRetentionArguments, AdminConversationsSetCustomRetentionResponse>;
Description

Set a conversation's retention policy.

See

`admin.conversations.setCustomRetention` API reference.

conversations.setTeams
setTeams: MethodWithRequiredArgument<AdminConversationsSetTeamsArguments, AdminConversationsSetTeamsResponse>;
Description

Set the workspaces in an Enterprise grid org that connect to a public or private channel.

See

`admin.conversations.setTeams` API reference.

conversations.unarchive
unarchive: MethodWithRequiredArgument<AdminConversationsUnarchiveArguments, AdminConversationsUnarchiveResponse>;
Description

Unarchive a public or private channel.

See

`admin.conversations.unarchive` API reference.

emoji

emoji: object;
emoji.add
add: MethodWithRequiredArgument<AdminEmojiAddArguments, AdminEmojiAddResponse>;
Description

Add an emoji.

See

`admin.emoji.add` API reference.

emoji.addAlias
addAlias: MethodWithRequiredArgument<AdminEmojiAddAliasArguments, AdminEmojiAddAliasResponse>;
Description

Add an emoji alias.

See

`admin.emoji.addAlias` API reference.

emoji.list
list: Method<TokenOverridable & CursorPaginationEnabled, AdminEmojiListResponse>;
Description

List emoji for an Enterprise Grid organization.

See

`admin.emoji.list` API reference.

emoji.remove
remove: MethodWithRequiredArgument<AdminEmojiRemoveArguments, AdminEmojiRemoveResponse>;
Description

Remove an emoji across an Enterprise Grid organization.

See

`admin.emoji.remove` API reference.

emoji.rename
rename: MethodWithRequiredArgument<AdminEmojiRenameArguments, AdminEmojiRenameResponse>;
Description

Rename an emoji.

See

`admin.emoji.rename` API reference.

functions

functions: object;
functions.list
list: MethodWithRequiredArgument<AdminFunctionsListArguments, AdminFunctionsListResponse>;
Description

Look up functions by a set of apps.

See

`admin.functions.list` API reference.

functions.permissions
permissions: object;
functions.permissions.lookup
lookup: MethodWithRequiredArgument<AdminFunctionsPermissionsLookupArguments, AdminFunctionsPermissionsLookupResponse>;
Description

Lookup the visibility of multiple Slack functions and include the users if it is limited to particular named entities.

See

`admin.functions.permissions.lookup` API reference.

functions.permissions.set
set: MethodWithRequiredArgument<AdminFunctionsPermissionsSetArguments, AdminFunctionsPermissionsSetResponse>;
Description

Set the visibility of a Slack function and define the users or workspaces if it is set to named_entities.

See

`admin.functions.permissions.set` API reference.

inviteRequests

inviteRequests: object;
inviteRequests.approve
approve: MethodWithRequiredArgument<AdminInviteRequestsApproveArguments, AdminInviteRequestsApproveResponse>;
Description

Approve a workspace invite request.

See

`admin.inviteRequests.approve` API reference.

inviteRequests.approved
approved: object;
inviteRequests.approved.list
list: MethodWithRequiredArgument<AdminInviteRequestsApprovedListArguments, AdminInviteRequestsApprovedListResponse>;
Description

List all approved workspace invite requests.

See

`admin.inviteRequests.approved.list` API reference.

inviteRequests.denied
denied: object;
inviteRequests.denied.list
list: MethodWithRequiredArgument<AdminInviteRequestsDeniedListArguments, AdminInviteRequestsDeniedListResponse>;
Description

List all denied workspace invite requests.

See

`admin.inviteRequests.denied.list` API reference.

inviteRequests.deny
deny: MethodWithRequiredArgument<AdminInviteRequestsDenyArguments, AdminInviteRequestsDenyResponse>;
Description

Deny a workspace invite request.

See

`admin.inviteRequests.deny` API reference.

inviteRequests.list
list: MethodWithRequiredArgument<AdminInviteRequestsListArguments, AdminInviteRequestsListResponse>;
Description

List all pending workspace invite requests.

See

`admin.inviteRequests.list` API reference.

roles

roles: object;
roles.addAssignments
addAssignments: MethodWithRequiredArgument<AdminRolesAddAssignmentsArguments, AdminRolesAddAssignmentsResponse>;
Description

Adds members to the specified role with the specified scopes.

See

`admin.roles.addAssignments` API reference.

roles.listAssignments
listAssignments: Method<Partial<EntityIDs> & TokenOverridable & CursorPaginationEnabled & SortDir & object, AdminRolesListAssignmentsResponse>;
Description

Lists assignments for all roles across entities. Options to scope results by any combination of roles or entities.

See

`admin.roles.listAssignments` API reference.

roles.removeAssignments
removeAssignments: MethodWithRequiredArgument<AdminRolesRemoveAssignmentsArguments, AdminRolesRemoveAssignmentsResponse>;
Description

Removes a set of users from a role for the given scopes and entities.

See

`admin.roles.removeAssignments` API reference.

teams

teams: object;
teams.admins
admins: object;
teams.admins.list
list: MethodWithRequiredArgument<AdminTeamsAdminsListArguments, AdminTeamsAdminsListResponse>;
Description

List all of the admins on a given workspace.

See

`admin.teams.admins.list` API reference.

teams.create
create: MethodWithRequiredArgument<AdminTeamsCreateArguments, AdminTeamsCreateResponse>;
Description

Create an Enterprise team.

See

`admin.teams.create` API reference.

teams.list
list: Method<TokenOverridable & CursorPaginationEnabled, AdminTeamsListResponse>;
Description

List all teams on an Enterprise organization.

See

`admin.teams.list` API reference.

teams.owners
owners: object;
teams.owners.list
list: MethodWithRequiredArgument<AdminTeamsOwnersListArguments, AdminTeamsOwnersListResponse>;
Description

List all of the owners on a given workspace.

See

`admin.teams.owners.list` API reference.

teams.settings
settings: object;
teams.settings.info
info: MethodWithRequiredArgument<AdminTeamsSettingsInfoArguments, AdminTeamsSettingsInfoResponse>;
Description

Fetch information about settings in a workspace.

See

`admin.teams.owners.list` API reference.

teams.settings.setDefaultChannels
setDefaultChannels: MethodWithRequiredArgument<AdminTeamsSettingsSetDefaultChannelsArguments, AdminTeamsSettingsSetDefaultChannelsResponse>;
Description

Set the default channels of a workspace.

See

`admin.teams.settings.setDefaultChannels` API reference.

teams.settings.setDescription
setDescription: MethodWithRequiredArgument<AdminTeamsSettingsSetDescriptionArguments, AdminTeamsSettingsSetDescriptionResponse>;
Description

Set the description of a given workspace.

See

`admin.teams.settings.setDescription` API reference.

teams.settings.setDiscoverability
setDiscoverability: MethodWithRequiredArgument<AdminTeamsSettingsSetDiscoverabilityArguments, AdminTeamsSettingsSetDiscoverabilityResponse>;
Description

Set the discoverability of a given workspace.

See

`admin.teams.settings.setDiscoverability` API reference.

teams.settings.setIcon
setIcon: MethodWithRequiredArgument<AdminTeamsSettingsSetIconArguments, AdminTeamsSettingsSetIconResponse>;
Description

Sets the icon of a workspace.

See

`admin.teams.settings.setIcon` API reference.

teams.settings.setName
setName: MethodWithRequiredArgument<AdminTeamsSettingsSetNameArguments, AdminTeamsSettingsSetNameResponse>;
Description

Set the name of a given workspace.

See

`admin.teams.settings.setName` API reference.

usergroups

usergroups: object;
usergroups.addChannels
addChannels: MethodWithRequiredArgument<AdminUsergroupsAddChannelsArguments, AdminUsergroupsAddChannelsResponse>;
Description

Add up to one hundred default channels to an IDP group.

See

`admin.teams.usergroups.addChannels` API reference.

usergroups.addTeams
addTeams: MethodWithRequiredArgument<AdminUsergroupsAddTeamsArguments, AdminUsergroupsAddTeamsResponse>;
Description

Associate one or more default workspaces with an organization-wide IDP group.

See

`admin.teams.usergroups.addTeams` API reference.

usergroups.listChannels
listChannels: MethodWithRequiredArgument<AdminUsergroupsListChannelsArguments, AdminUsergroupsListChannelsResponse>;
Description

List the channels linked to an org-level IDP group (user group).

See

`admin.teams.usergroups.listChannels` API reference.

usergroups.removeChannels
removeChannels: MethodWithRequiredArgument<AdminUsergroupsRemoveChannelsArguments, AdminUsergroupsRemoveChannelsResponse>;
Description

Remove one or more default channels from an org-level IDP group (user group).

See

`admin.teams.usergroups.removeChannels` API reference.

users

users: object;
users.assign
assign: MethodWithRequiredArgument<AdminUsersAssignArguments, AdminUsersAssignResponse>;
Description

Add an Enterprise user to a workspace.

See

`admin.users.assign` API reference.

users.invite
invite: MethodWithRequiredArgument<AdminUsersInviteArguments, AdminUsersInviteResponse>;
Description

Invite a user to a workspace.

See

`admin.users.invite` API reference.

users.list
list: Method<TeamIDOrDeactivatedWorkspaces & TokenOverridable & CursorPaginationEnabled & object, AdminUsersListResponse>;
Description

List users on a workspace.

See

`admin.users.list` API reference.

users.remove
remove: MethodWithRequiredArgument<AdminUsersRemoveArguments, AdminUsersRemoveResponse>;
Description

Remove a user from a workspace.

See

`admin.users.remove` API reference.

users.session
session: object;
users.session.clearSettings
clearSettings: MethodWithRequiredArgument<AdminUsersSessionClearSettingsArguments, AdminUsersSessionClearSettingsResponse>;
Description

Clear user-specific session settings—the session duration and what happens when the client closes—for a list of users.

See

`admin.users.session.clearSettings` API reference.

users.session.getSettings
getSettings: MethodWithRequiredArgument<AdminUsersSessionGetSettingsArguments, AdminUsersSessionGetSettingsResponse>;
Description

Get user-specific session settings—the session duration and what happens when the client closes—given a list of users.

See

`admin.users.session.getSettings` API reference.

users.session.invalidate
invalidate: MethodWithRequiredArgument<AdminUsersSessionInvalidateArguments, AdminUsersSessionInvalidateResponse>;
Description

Revoke a single session for a user. The user will be forced to login to Slack.

See

`admin.users.session.invalidate` API reference.

users.session.list
list: Method<EitherTeamAndUserIDOrNeither & TokenOverridable & CursorPaginationEnabled, AdminUsersSessionListResponse>;
Description

List active user sessions for an organization.

See

`admin.users.session.list` API reference.

users.session.reset
reset: MethodWithRequiredArgument<AdminUsersSessionResetArguments, AdminUsersSessionResetResponse>;
Description

Wipes all valid sessions on all devices for a given user.

See

`admin.users.session.reset` API reference.

users.session.resetBulk
resetBulk: MethodWithRequiredArgument<AdminUsersSessionResetBulkArguments, AdminUsersSessionResetBulkResponse>;
Description

Enqueues an asynchronous job to wipe all valid sessions on all devices for a given user list.

See

`admin.users.session.resetBulk` API reference.

users.session.setSettings
setSettings: MethodWithRequiredArgument<AdminUsersSessionSetSettingsArguments, AdminUsersSessionSetSettingsResponse>;
Description

Configure the user-level session settings—the session duration and what happens when the client closes—for one or more users.

See

`admin.users.session.setSettings` API reference.

users.setAdmin
setAdmin: MethodWithRequiredArgument<AdminUsersSetAdminArguments, AdminUsersSetAdminResponse>;
Description

Set an existing guest, regular user, or owner to be an admin user.

See

`admin.users.setAdmin` API reference.

users.setExpiration
setExpiration: MethodWithRequiredArgument<AdminUsersSetExpirationArguments, AdminUsersSetExpirationResponse>;
Description

Set an expiration for a guest user.

See

`admin.users.setExpiration` API reference.

users.setOwner
setOwner: MethodWithRequiredArgument<AdminUsersSetOwnerArguments, AdminUsersSetOwnerResponse>;
Description

Set an existing guest, regular user, or admin user to be a workspace owner.

See

`admin.users.setOwner` API reference.

users.setRegular
setRegular: MethodWithRequiredArgument<AdminUsersSetRegularArguments, AdminUsersSetRegularResponse>;
Description

Set an existing guest user, admin user, or owner to be a regular user.

See

`admin.users.setRegular` API reference.

users.unsupportedVersions
unsupportedVersions: object;
users.unsupportedVersions.export
export: MethodWithRequiredArgument<AdminUsersUnsupportedVersionsExportArguments, AdminUsersUnsupportedVersionsExportResponse>;
Description

Ask Slackbot to send you an export listing all workspace members using unsupported software, presented as a zipped CSV file.

See

`admin.users.unsupportedVersions.export` API reference.

workflows

workflows: object;
workflows.collaborators
collaborators: object;
workflows.collaborators.add
add: MethodWithRequiredArgument<AdminWorkflowsCollaboratorsAddArguments, AdminWorkflowsCollaboratorsAddResponse>;
Description

Add collaborators to workflows within the team or enterprise.

See

`admin.workflows.collaborators.add` API reference.

workflows.collaborators.remove
remove: MethodWithRequiredArgument<AdminWorkflowsCollaboratorsRemoveArguments, AdminWorkflowsCollaboratorsRemoveResponse>;
Description

Remove collaborators from workflows within the team or enterprise.

See

`admin.workflows.collaborators.remove` API reference.

workflows.permissions
permissions: object;
workflows.permissions.lookup
lookup: MethodWithRequiredArgument<AdminWorkflowsPermissionsLookupArguments, AdminWorkflowsPermissionsLookupResponse>;
Description

Look up the permissions for a set of workflows.

See

`admin.workflows.permissions.lookup` API reference.

workflows.search
search: Method<Partial<AppID> & Partial<CollaboratorIDs> & SortDir & TokenOverridable & CursorPaginationEnabled & object, AdminWorkflowsSearchResponse>;
Description

Search workflows within the team or enterprise.

See

`admin.workflows.search` API reference.

workflows.unpublish
unpublish: MethodWithRequiredArgument<AdminWorkflowsUnpublishArguments, AdminWorkflowsUnpublishResponse>;
Description

Unpublish workflows within the team or enterprise.

See

`admin.workflows.unpublish` API reference.

Inherited from

Methods.admin


api

readonly api: object;

Defined in: packages/web-api/src/methods.ts:1335

test

test: Method<{
error: string;
}, ApiTestResponse>;
Description

Checks API calling code.

See

`api.test` API reference.

Inherited from

Methods.api


apps

readonly apps: object;

Defined in: packages/web-api/src/methods.ts:1372

connections

connections: object;
connections.open
open: Method<object, AppsConnectionsOpenResponse>;
Description

Generate a temporary Socket Mode WebSocket URL that your app can connect to in order to receive events and interactive payloads over.

See

`apps.connections.open` API reference.

event

event: object;
event.authorizations
authorizations: object;
event.authorizations.list
list: MethodWithRequiredArgument<AppsEventAuthorizationsListArguments, AppsEventAuthorizationsListResponse>;
Description

Get a list of authorizations for the given event context. Each authorization represents an app installation that the event is visible to.

See

`apps.event.authorizations.list` API reference.

manifest

manifest: object;
manifest.create
create: MethodWithRequiredArgument<AppsManifestCreateArguments, AppsManifestCreateResponse>;
Description

Create an app from an app manifest.

See

`apps.manifest.create` API reference.

manifest.delete
delete: MethodWithRequiredArgument<AppsManifestDeleteArguments, AppsManifestDeleteResponse>;
Description

Permanently deletes an app created through app manifests.

See

`apps.manifest.delete` API reference.

manifest.export
export: MethodWithRequiredArgument<AppsManifestExportArguments, AppsManifestExportResponse>;
Description

Export an app manifest from an existing app.

See

`apps.manifest.export` API reference.

manifest.update
update: MethodWithRequiredArgument<AppsManifestUpdateArguments, AppsManifestUpdateResponse>;
Description

Update an app from an app manifest.

See

`apps.manifest.update` API reference.

manifest.validate
validate: MethodWithRequiredArgument<AppsManifestValidateArguments, AppsManifestValidateResponse>;
Description

Validate an app manifest.

See

`apps.manifest.validate` API reference.

uninstall

uninstall: MethodWithRequiredArgument<AppsUninstallArguments, AppsUninstallResponse>;
Description

Uninstalls your app from a workspace.

See

`apps.uninstall` API reference.

Inherited from

Methods.apps


assistant

readonly assistant: object;

Defined in: packages/web-api/src/methods.ts:1343

threads

threads: object;
threads.setStatus
setStatus: MethodWithRequiredArgument<AssistantThreadsSetStatusArguments, AssistantThreadsSetStatusResponse>;
Description

Set loading status to indicate that the app is building a response.

See

`assistant.threads.setStatus` API reference.

threads.setSuggestedPrompts
setSuggestedPrompts: MethodWithRequiredArgument<AssistantThreadsSetSuggestedPromptsArguments, AssistantThreadsSetSuggestedPromptsResponse>;
Description

Set suggested prompts for the user. Can suggest up to four prompts.

See

`assistant.threads.setSuggestedPrompts` API reference.

threads.setTitle
setTitle: MethodWithRequiredArgument<AssistantThreadsSetTitleArguments, AssistantThreadsSetTitleResponse>;
Description

Set the title of the thread. This is shown when a user views the app's chat history.

See

`assistant.threads.setTitle` API reference.

Inherited from

Methods.assistant


auth

readonly auth: object;

Defined in: packages/web-api/src/methods.ts:1434

revoke

revoke: Method<TokenOverridable & object, AuthRevokeResponse>;
Description

Revokes a token.

See

`auth.revoke` API reference.

teams

teams: object;
teams.list
list: Method<TokenOverridable & CursorPaginationEnabled & object, AuthTeamsListResponse>;
Description

Obtain a full list of workspaces your org-wide app has been approved for.

See

`auth.teams.list` API reference.

test

test: Method<TokenOverridable, AuthTestResponse>;

Inherited from

Methods.auth


bookmarks

readonly bookmarks: object;

Defined in: packages/web-api/src/methods.ts:1450

add

add: MethodWithRequiredArgument<BookmarksAddArguments, BookmarksAddResponse>;
Description

Add bookmark to a channel.

See

`bookmarks.add` API reference.

edit

edit: MethodWithRequiredArgument<BookmarksEditArguments, BookmarksEditResponse>;
Description

Edit bookmark.

See

`bookmarks.edit` API reference.

list

list: MethodWithRequiredArgument<BookmarksListArguments, BookmarksListResponse>;
Description

List bookmarks for a channel.

See

`bookmarks.list` API reference.

remove

remove: MethodWithRequiredArgument<BookmarksRemoveArguments, BookmarksRemoveResponse>;
Description

Remove bookmark from a channel.

See

`bookmarks.remove` API reference.

Inherited from

Methods.bookmarks


bots

readonly bots: object;

Defined in: packages/web-api/src/methods.ts:1473

info

info: Method<TokenOverridable & OptionalTeamAssignable & object, BotsInfoResponse>;
Description

Gets information about a bot user.

See

`bots.info` API reference.

Inherited from

Methods.bots


calls

readonly calls: object;

Defined in: packages/web-api/src/methods.ts:1481

add

add: MethodWithRequiredArgument<CallsAddArguments, CallsAddResponse>;
Description

Registers a new Call.

See

`calls.add` API reference.

end

end: MethodWithRequiredArgument<CallsEndArguments, CallsEndResponse>;
Description

Ends a Call.

See

`calls.end` API reference.

info

info: MethodWithRequiredArgument<CallsInfoArguments, CallsInfoResponse>;
Description

Returns information about a Call.

See

`calls.info` API reference.

participants

participants: object;
participants.add
add: MethodWithRequiredArgument<CallsParticipantsAddArguments, CallsParticipantsAddResponse>;
Description

Registers new participants added to a Call.

See

`calls.participants.add` API reference.

participants.remove
remove: MethodWithRequiredArgument<CallsParticipantsRemoveArguments, CallsParticipantsRemoveResponse>;

update

update: MethodWithRequiredArgument<CallsUpdateArguments, CallsUpdateResponse>;
Description

Updates information about a Call.

See

`calls.info` API reference.

Inherited from

Methods.calls


canvases

readonly canvases: object;

Defined in: packages/web-api/src/methods.ts:1515

access

access: object;
access.delete
delete: MethodWithRequiredArgument<CanvasesAccessDeleteArguments, CanvasesAccessDeleteResponse>;
Description

Remove access to a canvas for specified entities.

See

`canvases.access.delete` API reference.

access.set
set: MethodWithRequiredArgument<CanvasesAccessSetArguments, CanvasesAccessSetResponse>;
Description

Sets the access level to a canvas for specified entities.

See

`canvases.access.set` API reference.

create

create: Method<TokenOverridable & object, CanvasesCreateResponse>;
Description

Create Canvas for a user.

See

`canvases.create` API reference.

delete

delete: MethodWithRequiredArgument<CanvasesDeleteArguments, CanvasesDeleteResponse>;
Description

Deletes a canvas.

See

`canvases.delete` API reference.

edit

edit: MethodWithRequiredArgument<CanvasesEditArguments, CanvasesEditResponse>;
Description

Update an existing canvas.

See

`canvases.edit` API reference.

sections

sections: object;
sections.lookup
lookup: MethodWithRequiredArgument<CanvasesSectionsLookupArguments, CanvasesSectionsLookupResponse>;
Description

Find sections matching the provided criteria.

See

`canvases.sections.lookup` API reference.

Inherited from

Methods.canvases


chat

readonly chat: object;

Defined in: packages/web-api/src/methods.ts:1555

delete

delete: MethodWithRequiredArgument<ChatDeleteArguments, ChatDeleteResponse>;
Description

Deletes a message.

See

`chat.delete` API reference.

deleteScheduledMessage

deleteScheduledMessage: MethodWithRequiredArgument<ChatDeleteScheduledMessageArguments, ChatDeleteScheduledMessageResponse>;
Description

Deletes a pending scheduled message from the queue.

See

`chat.deleteScheduledMessage` API reference.

getPermalink: MethodWithRequiredArgument<ChatGetPermalinkArguments, ChatGetPermalinkResponse>;
Description

Retrieve a permalink URL for a specific extant message.

See

`chat.getPermalink` API reference.

meMessage

meMessage: MethodWithRequiredArgument<ChatMeMessageArguments, ChatMeMessageResponse>;
Description

Share a me message into a channel.

See

`chat.meMessage` API reference.

postEphemeral

postEphemeral: MethodWithRequiredArgument<ChatPostEphemeralArguments, ChatPostEphemeralResponse>;
Description

Sends an ephemeral message to a user in a channel.

See

`chat.postEphemeral` API reference.

postMessage

postMessage: MethodWithRequiredArgument<ChatPostMessageArguments, ChatPostMessageResponse>;
Description

Sends a message to a channel.

See

`chat.postMessage` API reference.

scheduledMessages

scheduledMessages: object;
scheduledMessages.list
list: Method<TokenOverridable & CursorPaginationEnabled & OptionalTeamAssignable & Pick<TimelinePaginationEnabled, "latest" | "oldest"> & Partial<Channel>, ChatScheduledMessagesListResponse>;
Description

Returns a list of scheduled messages.

See

`chat.scheduledMessages.list` API reference.

scheduleMessage

scheduleMessage: MethodWithRequiredArgument<ChatScheduleMessageArguments, ChatScheduleMessageResponse>;
Description

Schedules a message to be sent to a channel.

See

`chat.scheduleMessage` API reference.

unfurl

unfurl: MethodWithRequiredArgument<ChatUnfurlArguments, ChatUnfurlResponse>;
Description

Provide custom unfurl behavior for user-posted URLs.

See

`chat.unfurl` API reference.

update

update: MethodWithRequiredArgument<ChatUpdateArguments, ChatUpdateResponse>;
Description

Updates a message.

See

`chat.update` API reference.

Inherited from

Methods.chat


conversations

readonly conversations: object;

Defined in: packages/web-api/src/methods.ts:1619

acceptSharedInvite

acceptSharedInvite: MethodWithRequiredArgument<ConversationsAcceptSharedInviteArguments, ConversationsAcceptSharedInviteResponse>;
Description

Accepts an invitation to a Slack Connect channel.

See

`conversations.acceptSharedInvite` API reference.

approveSharedInvite

approveSharedInvite: MethodWithRequiredArgument<ConversationsApproveSharedInviteArguments, ConversationsApproveSharedInviteResponse>;
Description

Approves an invitation to a Slack Connect channel.

See

`conversations.approveSharedInvite` API reference.

archive

archive: MethodWithRequiredArgument<ConversationsArchiveArguments, ConversationsArchiveResponse>;
Description

Archives a conversation.

See

`conversations.archive` API reference.

canvases

canvases: object;
canvases.create
create: MethodWithRequiredArgument<ConversationsCanvasesCreateArguments, ConversationsCanvasesCreateResponse>;
Description

Create a Channel Canvas for a channel.

See

`conversations.canvases.create` API reference.

close

close: MethodWithRequiredArgument<ConversationsCloseArguments, ConversationsCloseResponse>;
Description

Closes a direct message or multi-person direct message.

See

`conversations.close` API reference.

create

create: MethodWithRequiredArgument<ConversationsCreateArguments, ConversationsCreateResponse>;
Description

Initiates a public or private channel-based conversation.

See

`conversations.create` API reference.

declineSharedInvite

declineSharedInvite: MethodWithRequiredArgument<ConversationsDeclineSharedInviteArguments, ConversationsDeclineSharedInviteResponse>;
Description

Declines an invitation to a Slack Connect channel.

See

`conversations.declineSharedInvite` API reference.

externalInvitePermissions

externalInvitePermissions: object;
externalInvitePermissions.set
set: MethodWithRequiredArgument<ConversationsExternalInvitePermissionsSetArguments, ConversationsExternalInvitePermissionsSetResponse>;
Description

Convert a team in a shared channel from an External Limited channel to a fully shared Slack Connect channel or vice versa.

See

`conversations.externalInvitePermissions.set` API reference.

history

history: MethodWithRequiredArgument<ConversationsHistoryArguments, ConversationsHistoryResponse>;
Description

Fetches a conversation's history of messages and events.

See

`conversations.history` API reference.

info

info: MethodWithRequiredArgument<ConversationsInfoArguments, ConversationsInfoResponse>;
Description

Retrieve information about a conversation.

See

`conversations.info` API reference.

invite

invite: MethodWithRequiredArgument<ConversationsInviteArguments, ConversationsInviteResponse>;
Description

Invites users to a channel.

See

`conversations.invite` API reference.

inviteShared

inviteShared: MethodWithRequiredArgument<ConversationsInviteSharedArguments, ConversationsInviteSharedResponse>;
Description

Sends an invitation to a Slack Connect channel.

See

`conversations.inviteShared` API reference.

join

join: MethodWithRequiredArgument<ConversationsJoinArguments, ConversationsJoinResponse>;
Description

Joins an existing conversation.

See

`conversations.join` API reference.

kick

kick: MethodWithRequiredArgument<ConversationsKickArguments, ConversationsKickResponse>;
Description

Removes a user from a conversation.

See

`conversations.kick` API reference.

leave

leave: MethodWithRequiredArgument<ConversationsLeaveArguments, ConversationsLeaveResponse>;
Description

Leaves a conversation.

See

`conversations.leave` API reference.

list

list: Method<TokenOverridable & CursorPaginationEnabled & OptionalTeamAssignable & object, ConversationsListResponse>;
Description

List all channels in a Slack team.

See

`conversations.list` API reference.

listConnectInvites

listConnectInvites: Method<TokenOverridable & OptionalTeamAssignable & object, ConversationsListConnectInvitesResponse>;
Description

Lists shared channel invites that have been generated or received but have not been approved by all parties.

See

`conversations.listConnectInvites` API reference.

mark

mark: MethodWithRequiredArgument<ConversationsMarkArguments, ConversationsMarkResponse>;
Description

Sets the read cursor in a channel.

See

`conversations.mark` API reference.

members

members: MethodWithRequiredArgument<ConversationsMembersArguments, ConversationsMembersResponse>;
Description

Retrieve members of a conversation.

See

`conversations.members` API reference.

open

open: MethodWithRequiredArgument<ConversationsOpenArguments, ConversationsOpenResponse>;
Description

Opens or resumes a direct message or multi-person direct message.

See

`conversations.open` API reference.

rename

rename: MethodWithRequiredArgument<ConversationsRenameArguments, ConversationsRenameResponse>;
Description

Renames a conversation.

See

`conversations.rename` API reference.

replies

replies: MethodWithRequiredArgument<ConversationsRepliesArguments, ConversationsRepliesResponse>;
Description

Retrieve a thread of messages posted to a conversation.

See

`conversations.replies` API reference.

requestSharedInvite

requestSharedInvite: object;
requestSharedInvite.approve
approve: MethodWithRequiredArgument<ConversationsRequestSharedInviteApproveArguments, ConversationsRequestSharedInviteApproveResponse>;
Description

Approves a request to add an external user to a channel and sends them a Slack Connect invite.

See

`conversations.requestSharedInvite.approve` API reference.

requestSharedInvite.deny
deny: MethodWithRequiredArgument<ConversationsRequestSharedInviteDenyArguments, ConversationsRequestSharedInviteDenyResponse>;
Description

Denies a request to invite an external user to a channel.

See

`conversations.requestSharedInvite.deny` API reference.

requestSharedInvite.list
list: Method<CursorPaginationEnabled & TokenOverridable & object, ConversationsRequestSharedInviteListResponse>;
Description

Lists requests to add external users to channels with ability to filter.

See

`conversations.requestSharedInvite.list` API reference.

setPurpose

setPurpose: MethodWithRequiredArgument<ConversationsSetPurposeArguments, ConversationsSetPurposeResponse>;
Description

Sets the purpose for a conversation.

See

`conversations.setPurpose` API reference.

setTopic

setTopic: MethodWithRequiredArgument<ConversationsSetTopicArguments, ConversationsSetTopicResponse>;
Description

Sets the topic for a conversation.

See

`conversations.setTopic` API reference.

unarchive

unarchive: MethodWithRequiredArgument<ConversationsUnarchiveArguments, ConversationsUnarchiveResponse>;
Description

Reverses conversation archival.

See

`conversations.unarchive` API reference.

Inherited from

Methods.conversations


dialog

readonly dialog: object;

Defined in: packages/web-api/src/methods.ts:1812

open

open: MethodWithRequiredArgument<DialogOpenArguments, DialogOpenResponse>;
Description

Open a dialog with a user.

See

`dialog.open` API reference.

Inherited from

Methods.dialog


dnd

readonly dnd: object;

Defined in: packages/web-api/src/methods.ts:1820

endDnd

endDnd: Method<TokenOverridable, DndEndDndResponse>;
Description

Ends the current user's Do Not Disturb session immediately.

See

`dnd.endDnd` API reference.

endSnooze

endSnooze: Method<TokenOverridable, DndEndSnoozeResponse>;
Description

Ends the current user's snooze mode immediately.

See

`dnd.endSnooze` API reference.

info

info: Method<TokenOverridable & OptionalTeamAssignable & object, DndInfoResponse>;
Description

Retrieves a user's current Do Not Disturb status.

See

`dnd.info` API reference.

setSnooze

setSnooze: MethodWithRequiredArgument<DndSetSnoozeArguments, DndSetSnoozeResponse>;
Description

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

See

`dnd.setSnooze` API reference.

teamInfo

teamInfo: MethodWithRequiredArgument<DndTeamInfoArguments, DndTeamInfoResponse>;
Description

Retrieves the Do Not Disturb status for up to 50 users on a team.

See

`dnd.teamInfo` API reference.

Inherited from

Methods.dnd


emoji

readonly emoji: object;

Defined in: packages/web-api/src/methods.ts:1848

list

list: Method<TokenOverridable & object, EmojiListResponse>;
Description

Lists custom emoji for a team.

See

`emoji.list` API reference.

Inherited from

Methods.emoji


files

readonly files: object;

Defined in: packages/web-api/src/methods.ts:1856

comments

comments: object;
comments.delete
delete: MethodWithRequiredArgument<FilesCommentsDeleteArguments, FilesCommentsDeleteResponse>;
Description

Deletes an existing comment on a file.

See

`files.comments.delete` API reference.

completeUploadExternal

completeUploadExternal: MethodWithRequiredArgument<FilesCompleteUploadExternalArguments, FilesCompleteUploadExternalResponse>;
Description

Finishes an upload started with `files.getUploadURLExternal`.

See

`files.completeUploadExternal` API reference.

delete

delete: MethodWithRequiredArgument<FilesDeleteArguments, FilesDeleteResponse>;
Description

Deletes a file.

See

`files.delete` API reference.

getUploadURLExternal

getUploadURLExternal: MethodWithRequiredArgument<FilesGetUploadURLExternalArguments, FilesGetUploadURLExternalResponse>;
Description

Gets a URL for an edge external file upload.

See

`files.getUploadURLExternal` API reference.

info

info: MethodWithRequiredArgument<FilesInfoArguments, FilesInfoResponse>;
Description

Gets information about a file.

See

`files.info` API reference.

list

list: MethodWithRequiredArgument<FilesListArguments, FilesListResponse>;
Description

List files for a team, in a channel, or from a user with applied filters.

See

`files.list` API reference.

remote

remote: object;
remote.add
add: MethodWithRequiredArgument<FilesRemoteAddArguments, FilesRemoteAddResponse>;
Description

Adds a file from a remote service.

See

`files.remote.add` API reference.

remote.info
info: MethodWithRequiredArgument<FilesRemoteInfoArguments, FilesRemoteInfoResponse>;
Description

Retrieve information about a remote file added to Slack.

See

`files.remote.info` API reference.

remote.list
list: MethodWithRequiredArgument<FilesRemoteListArguments, FilesRemoteListResponse>;
Description

List remote files added to Slack.

See

`files.remote.list` API reference.

remote.remove
remove: MethodWithRequiredArgument<FilesRemoteRemoveArguments, FilesRemoteRemoveResponse>;
Description

Remove a remote file.

See

`files.remote.remove` API reference.

remote.share
share: MethodWithRequiredArgument<FilesRemoteShareArguments, FilesRemoteShareResponse>;
Description

Share a remote file into a channel.

See

`files.remote.share` API reference.

remote.update
update: MethodWithRequiredArgument<FilesRemoteUpdateArguments, FilesRemoteUpdateResponse>;
Description

Updates an existing remote file.

See

`files.remote.update` API reference.

revokePublicURL

revokePublicURL: MethodWithRequiredArgument<FilesRevokePublicURLArguments, FilesRevokePublicURLResponse>;
Description

Revokes public/external sharing access for a file.

See

`files.revokePublicURL` API reference.

sharedPublicURL

sharedPublicURL: MethodWithRequiredArgument<FilesSharedPublicURLArguments, FilesSharedPublicURLResponse>;
Description

Enables a file for public/external sharing.

See

`files.revokePublicURL` API reference.

upload

upload: MethodWithRequiredArgument<FilesUploadArguments, FilesUploadResponse>;
Description

Uploads or creates a file.

Deprecated

Use uploadV2 instead. See our post on retiring `files.upload`.

See

`files.upload` API reference.

uploadV2

uploadV2: MethodWithRequiredArgument<FilesUploadV2Arguments, WebAPICallResult>;
Description

Custom method to support a new way of uploading files to Slack. Supports a single file upload Supply:

  • (required) single file or content
  • (optional) channel, alt_text, snippet_type, Supports multiple file uploads Supply:
  • multiple upload_files Will try to honor both single file or content data supplied as well as multiple file uploads property.
See

`@slack/web-api` Upload a file documentation.

Inherited from

Methods.files


functions

readonly functions: object;

Defined in: packages/web-api/src/methods.ts:1965

completeError

completeError: MethodWithRequiredArgument<FunctionsCompleteErrorArguments, FunctionsCompleteErrorResponse>;
Description

Signal the failure to execute a Custom Function.

See

`functions.completeError` API reference.

completeSuccess

completeSuccess: MethodWithRequiredArgument<FunctionsCompleteSuccessArguments, FunctionsCompleteSuccessResponse>;
Description

Signal the successful completion of a Custom Function.

See

`functions.completeSuccess` API reference.

Inherited from

Methods.functions


migration

readonly migration: object;

Defined in: packages/web-api/src/methods.ts:1984

exchange

exchange: MethodWithRequiredArgument<MigrationExchangeArguments, MigrationExchangeResponse>;
Description

For Enterprise Grid workspaces, map local user IDs to global user IDs.

See

`migration.exchange` API reference.

Inherited from

Methods.migration


oauth

readonly oauth: object;

Defined in: packages/web-api/src/methods.ts:1992

access

access: MethodWithRequiredArgument<OAuthAccessArguments, OauthAccessResponse>;
Description

Exchanges a temporary OAuth verifier code for an access token.

Deprecated

This is a legacy method only used by classic Slack apps. Use oauth.v2.access for new Slack apps.

See

`oauth.access` API reference.

v2

v2: object;
v2.access
access: MethodWithRequiredArgument<OAuthV2AccessArguments, OauthV2AccessResponse>;
Description

Exchanges a temporary OAuth verifier code for an access token.

See

`oauth.v2.access` API reference.

v2.exchange
exchange: MethodWithRequiredArgument<OAuthV2ExchangeArguments, OauthV2ExchangeResponse>;
Description

Exchanges a legacy access token for a new expiring access token and refresh token.

See

`oauth.v2.exchange` API reference.

Inherited from

Methods.oauth


openid

readonly openid: object;

Defined in: packages/web-api/src/methods.ts:2013

connect

connect: object;
connect.token
token: MethodWithRequiredArgument<OpenIDConnectTokenArguments, OpenIDConnectTokenResponse>;
Description

Exchanges a temporary OAuth verifier code for an access token for Sign in with Slack.

See

`openid.connect.token` API reference.

connect.userInfo
userInfo: Method<object, OpenIDConnectUserInfoResponse>;
Description

Get the identity of a user who has authorized Sign in with Slack.

See

`openid.connect.userInfo` API reference.

Inherited from

Methods.openid


pins

readonly pins: object;

Defined in: packages/web-api/src/methods.ts:2031

add

add: MethodWithRequiredArgument<PinsAddArguments, PinsAddResponse>;
Description

Pins an item to a channel.

See

`pins.add` API reference.

list

list: MethodWithRequiredArgument<PinsListArguments, PinsListResponse>;
Description

Lists items pinned to a channel.

See

`pins.list` API reference.

remove

remove: MethodWithRequiredArgument<PinsRemoveArguments, PinsRemoveResponse>;
Description

Un-pins an item from a channel.

See

`pins.remove` API reference.

Inherited from

Methods.pins


reactions

readonly reactions: object;

Defined in: packages/web-api/src/methods.ts:2049

add

add: MethodWithRequiredArgument<ReactionsAddArguments, ReactionsAddResponse>;
Description

Adds a reaction to an item.

See

`reactions.add` API reference.

get

get: MethodWithRequiredArgument<ReactionsGetArguments, ReactionsGetResponse>;
Description

Gets reactions for an item.

See

`reactions.get` API reference.

list

list: Method<ReactionsFull & TokenOverridable & TraditionalPagingEnabled & CursorPaginationEnabled & OptionalTeamAssignable & object, ReactionsListResponse>;
Description

List reactions made by a user.

See

`reactions.list` API reference.

remove

remove: MethodWithRequiredArgument<ReactionsRemoveArguments, ReactionsRemoveResponse>;
Description

Removes a reaction from an item.

See

`reactions.remove` API reference.

Inherited from

Methods.reactions


reminders

readonly reminders: object;

Defined in: packages/web-api/src/methods.ts:2074

add

add: MethodWithRequiredArgument<RemindersAddArguments, RemindersAddResponse>;
Description

Creates a reminder.

See

`reminders.add` API reference.

complete

complete: MethodWithRequiredArgument<RemindersCompleteArguments, RemindersCompleteResponse>;
Description

Marks a reminder as complete.

See

`reminders.complete` API reference.

delete

delete: MethodWithRequiredArgument<RemindersDeleteArguments, RemindersDeleteResponse>;
Description

Deletes a reminder.

See

`reminders.delete` API reference.

info

info: MethodWithRequiredArgument<RemindersInfoArguments, RemindersInfoResponse>;
Description

Gets information about a reminder.

See

`reminders.info` API reference.

list

list: Method<TokenOverridable & OptionalTeamAssignable, RemindersListResponse>;
Description

Lists all reminders created by or for a given user.

See

`reminders.list` API reference.

Inherited from

Methods.reminders


rtm

readonly rtm: object;

Defined in: packages/web-api/src/methods.ts:2102

connect

connect: Method<TokenOverridable & object, RtmConnectResponse>;
Description

Starts a Real Time Messaging session.

See

`rtm.connect` API reference.

start

start: Method<TokenOverridable & object & LocaleAware & object, RtmStartResponse>;
Description

Starts a Real Time Messaging session.

Deprecated

Use rtm.connect instead. See our post on retiring `rtm.start`.

See

`rtm.start` API reference.

Inherited from

Methods.rtm


readonly search: object;

Defined in: packages/web-api/src/methods.ts:2116

all

all: MethodWithRequiredArgument<SearchAllArguments, SearchAllResponse>;
Description

Searches for messages and files matching a query.

See

search.all` API reference.

files

files: MethodWithRequiredArgument<SearchFilesArguments, SearchFilesResponse>;
Description

Searches for files matching a query.

See

search.files` API reference.

messages

messages: MethodWithRequiredArgument<SearchMessagesArguments, SearchMessagesResponse>;
Description

Searches for messages matching a query.

See

search.messages` API reference.

Inherited from

Methods.search


slackApiUrl

readonly slackApiUrl: string;

Defined in: packages/web-api/src/WebClient.ts:195

The base URL for reaching Slack's Web API. Consider changing this value for testing purposes.


stars

readonly stars: object;

Defined in: packages/web-api/src/methods.ts:2358

add

add: MethodWithRequiredArgument<StarsAddRemoveArguments, StarsAddResponse>;
Description

Save an item for later. Formerly known as adding a star.

Deprecated

Stars can still be added but they can no longer be viewed or interacted with by end-users. See our post on stars and the Later list.

See

`stars.add` API reference.

list

list: MethodWithRequiredArgument<StarsListArguments, StarsListResponse>;
Description

List a user's saved items, formerly known as stars.

Deprecated

Stars can still be listed but they can no longer be viewed or interacted with by end-users. See our post on stars and the Later list.

See

`stars.list` API reference.

remove

remove: MethodWithRequiredArgument<StarsAddRemoveArguments, StarsRemoveResponse>;
Description

Remove a saved item from a user's saved items, formerly known as stars.

Deprecated

Stars can still be removed but they can no longer be viewed or interacted with by end-users. See our post on stars and the Later list.

See

`stars.remove` API reference.

Inherited from

Methods.stars


team

readonly team: object;

Defined in: packages/web-api/src/methods.ts:2134

accessLogs

accessLogs: Method<TokenOverridable & CursorPaginationEnabled & TraditionalPagingEnabled & OptionalTeamAssignable & object, TeamAccessLogsResponse>;
Description

Gets the access logs for the current team.

See

`team.accessLogs` API reference.

billableInfo

billableInfo: Method<TokenOverridable & CursorPaginationEnabled & OptionalTeamAssignable & object, TeamBillableInfoResponse>;
Description

Gets billable users information for the current team.

See

`team.billableInfo` API reference.

billing

billing: object;
billing.info
info: MethodWithRequiredArgument<TokenOverridable, TeamBillingInfoResponse>;
Description

Reads a workspace's billing plan information.

See

`team.billing.info` API reference.

externalTeams

externalTeams: object;
externalTeams.disconnect
disconnect: MethodWithRequiredArgument<TeamExternalTeamsDisconnectArguments, TeamExternalTeamsDisconnectResponse>;
Description

Disconnect an external organization.

See

`team.externalTeams.disconnect` API reference.

externalTeams.list
list: MethodWithRequiredArgument<TokenOverridable & CursorPaginationEnabled & object, TeamExternalTeamsListResponse>;
Description

Returns a list of all the external teams connected and details about the connection.

See

`team.externalTeams.list` API reference.

info

info: Method<TokenOverridable & object, TeamInfoResponse>;
Description

Gets information about the current team.

See

`team.info` API reference.

integrationLogs

integrationLogs: Method<Partial<AppID> & TokenOverridable & OptionalTeamAssignable & TraditionalPagingEnabled & object, TeamIntegrationLogsResponse>;
Description

Gets the integration logs for the current team.

See

`team.integrationLogs` API reference.

preferences

preferences: object;
preferences.list
list: Method<TokenOverridable, TeamPreferencesListResponse>;
Description

Retrieve a list of a workspace's team preferences.

See

`team.preferences.list` API reference.

profile

profile: object;
profile.get
get: Method<TokenOverridable & object, TeamProfileGetResponse>;
Description

Retrieve a team's profile.

See

`team.profile.get` API reference.

Inherited from

Methods.team


token?

readonly optional token: string;

Defined in: packages/web-api/src/WebClient.ts:200

Authentication and authorization token for accessing Slack Web API (usually begins with xoxp or xoxb)


tooling

readonly tooling: object;

Defined in: packages/web-api/src/methods.ts:2205

tokens

tokens: object;
tokens.rotate
rotate: MethodWithRequiredArgument<ToolingTokensRotateArguments, ToolingTokensRotateResponse>;
Description

Exchanges a refresh token for a new app configuration token.

See

`tooling.tokens.rotate` API reference.

Inherited from

Methods.tooling


usergroups

readonly usergroups: object;

Defined in: packages/web-api/src/methods.ts:2215

create

create: MethodWithRequiredArgument<UsergroupsCreateArguments, UsergroupsCreateResponse>;
Description

Create a User Group.

See

`usergroups.create` API reference.

disable

disable: MethodWithRequiredArgument<UsergroupsDisableArguments, UsergroupsDisableResponse>;
Description

Disable an existing User Group.

See

`usergroups.disable` API reference.

enable

enable: MethodWithRequiredArgument<UsergroupsEnableArguments, UsergroupsEnableResponse>;
Description

Enable an existing User Group.

See

`usergroups.enable` API reference.

list

list: Method<TokenOverridable & OptionalTeamAssignable & UsergroupsIncludeCount & object, UsergroupsListResponse>;
Description

List all User Groups for a team.

See

`usergroups.list` API reference.

update

update: MethodWithRequiredArgument<UsergroupsUpdateArguments, UsergroupsUpdateResponse>;
Description

Update an existing User Group.

See

`usergroups.update` API reference.

users

users: object;
users.list
list: MethodWithRequiredArgument<UsergroupsUsersListArguments, UsergroupsUsersListResponse>;
Description

List all users in a User Group.

See

`usergroups.users.list` API reference.

users.update
update: MethodWithRequiredArgument<UsergroupsUsersUpdateArguments, UsergroupsUsersUpdateResponse>;
Description

Update the list of users in a User Group.

See

`usergroups.users.update` API reference.

Inherited from

Methods.usergroups


users

readonly users: object;

Defined in: packages/web-api/src/methods.ts:2258

conversations

conversations: MethodWithRequiredArgument<UsersConversationsArguments, UsersConversationsResponse>;
Description

List conversations the calling user may access.

See

`users.conversations` API reference.

deletePhoto

deletePhoto: MethodWithRequiredArgument<UsersDeletePhotoArguments, UsersDeletePhotoResponse>;
Description

Delete the user profile photo.

See

`users.deletePhoto` API reference.

discoverableContacts

discoverableContacts: object;
discoverableContacts.lookup
lookup: MethodWithRequiredArgument<UsersDiscoverableContactsLookupArguments, UsersDiscoverableContactsLookupResponse>;
Description

Lookup an email address to see if someone is on Slack.

See

`users.discoverableContacts.lookup` API reference.

getPresence

getPresence: MethodWithRequiredArgument<UsersGetPresenceArguments, UsersGetPresenceResponse>;
Description

Gets user presence information.

See

`users.getPresence` API reference.

identity

identity: MethodWithRequiredArgument<UsersIdentityArguments, UsersIdentityResponse>;
Description

Get a user's identity.

See

`users.identity` API reference.

info

info: MethodWithRequiredArgument<UsersInfoArguments, UsersInfoResponse>;
Description

Gets information about a user.

See

`users.info` API reference.

list

list: MethodWithRequiredArgument<UsersListArguments, UsersListResponse>;
Description

Lists all users in a Slack team.

See

`users.list` API reference.

lookupByEmail

lookupByEmail: MethodWithRequiredArgument<UsersLookupByEmailArguments, UsersLookupByEmailResponse>;
Description

Find a user with an email address.

See

`users.lookupByEmail` API reference.

profile

profile: object;
profile.get
get: MethodWithRequiredArgument<UsersProfileGetArguments, UsersProfileGetResponse>;
Description

Retrieve a user's profile information, including their custom status.

See

`users.profile.get` API reference.

profile.set
set: MethodWithRequiredArgument<UsersProfileSetArguments, UsersProfileSetResponse>;
Description

Set a user's profile information, including custom status.

See

`users.profile.set` API reference.

setPhoto

setPhoto: MethodWithRequiredArgument<UsersSetPhotoArguments, UsersSetPhotoResponse>;
Description

Set the user profile photo.

See

`users.setPhoto` API reference.

setPresence

setPresence: MethodWithRequiredArgument<UsersSetPresenceArguments, UsersSetPresenceResponse>;
Description

Manually sets user presence.

See

`users.setPresence` API reference.

Inherited from

Methods.users


views

readonly views: object;

Defined in: packages/web-api/src/methods.ts:2328

open

open: MethodWithRequiredArgument<ViewsOpenArguments, ViewsOpenResponse>;
Description

Open a view for a user.

See

`views.open` API reference.

publish

publish: MethodWithRequiredArgument<ViewsPublishArguments, ViewsPublishResponse>;
Description

Publish a static view for a user.

See

`views.publish` API reference.

push

push: MethodWithRequiredArgument<ViewsPushArguments, ViewsPushResponse>;
Description

Push a view onto the stack of a root view.

See

`views.push` API reference.

update

update: MethodWithRequiredArgument<ViewsUpdateArguments, ViewsUpdateResponse>;
Description

Update an existing view.

See

`views.update` API reference.

Inherited from

Methods.views


workflows

readonly workflows: object;

Defined in: packages/web-api/src/methods.ts:2382

stepCompleted

stepCompleted: MethodWithRequiredArgument<WorkflowsStepCompletedArguments, WorkflowsStepCompletedResponse>;
Description

Indicate that an app's step in a workflow completed execution.

Deprecated

Steps from Apps is deprecated. We're retiring all Slack app functionality around Steps from Apps in September 2024. See our post on deprecating Steps from Apps.

See

`workflows.stepCompleted` API reference.

stepFailed

stepFailed: MethodWithRequiredArgument<WorkflowsStepFailedArguments, WorkflowsStepFailedResponse>;
Description

Indicate that an app's step in a workflow failed to execute.

Deprecated

Steps from Apps is deprecated. We're retiring all Slack app functionality around Steps from Apps in September 2024. See our post on deprecating Steps from Apps.

See

`workflows.stepFailed` API reference.

updateStep

updateStep: MethodWithRequiredArgument<WorkflowsUpdateStepArguments, WorkflowsUpdateStepResponse>;
Description

Update the configuration for a workflow step.

Deprecated

Steps from Apps is deprecated. We're retiring all Slack app functionality around Steps from Apps in September 2024. See our post on deprecating Steps from Apps.

See

`workflows.updateStep` API reference.

Inherited from

Methods.workflows

Methods

apiCall()

apiCall(method, options): Promise<WebAPICallResult>

Defined in: packages/web-api/src/WebClient.ts:345

Generic method for calling a Web API method

Parameters

method

string

the Web API method to call https://api.slack.com/methods

options

Record<string, unknown> = {}

options

Returns

Promise<WebAPICallResult>

Overrides

Methods.apiCall


filesUploadV2()

filesUploadV2(options): Promise<WebAPICallResult & object>

Defined in: packages/web-api/src/WebClient.ts:523

This wrapper method provides an easy way to upload files using the following endpoints:

#1: For each file submitted with this method, submit filenames and file metadata to files.getUploadURLExternal to request a URL to which to send the file data to and an id for the file

#2: for each returned file upload_url, upload corresponding file to URLs returned from step 1 (e.g. https://files.slack.com/upload/v1/...\")

#3: Complete uploads files.completeUploadExternal

Parameters

options

FilesUploadV2Arguments

Returns

Promise<WebAPICallResult & object>

Overrides

Methods.filesUploadV2


paginate()

Call Signature

paginate(method, options?): AsyncIterable<WebAPICallResult>

Defined in: packages/web-api/src/WebClient.ts:431

Iterate over the result pages of a cursor-paginated Web API method. This method can return two types of values, depending on which arguments are used. When up to two parameters are used, the return value is an async iterator which can be used as the iterable in a for-await-of loop. When three or four parameters are used, the return value is a promise that resolves at the end of iteration. The third parameter, shouldStop, is a function that is called with each page and can end iteration by returning true. The fourth parameter, reduce, is a function that is called with three arguments: accumulator, page, and index. The accumulator is a value of any type you choose, but it will contain undefined when reduce is called for the first time. The page argument and index arguments are exactly what they say they are. The reduce function's return value will be passed in as accumulator the next time its called, and the returned promise will resolve to the last value of accumulator.

The for-await-of syntax is part of ES2018. It is available natively in Node starting with v10.0.0. You may be able to use it in earlier JavaScript runtimes by transpiling your source with a tool like Babel. However, the transpiled code will likely sacrifice performance.

Parameters
method

string

the cursor-paginated Web API method to call https://api.slack.com/docs/pagination

options?

Record<string, unknown>

options

Returns

AsyncIterable<WebAPICallResult>

Call Signature

paginate(
method,
options,
shouldStop): Promise<void>

Defined in: packages/web-api/src/WebClient.ts:432

Iterate over the result pages of a cursor-paginated Web API method. This method can return two types of values, depending on which arguments are used. When up to two parameters are used, the return value is an async iterator which can be used as the iterable in a for-await-of loop. When three or four parameters are used, the return value is a promise that resolves at the end of iteration. The third parameter, shouldStop, is a function that is called with each page and can end iteration by returning true. The fourth parameter, reduce, is a function that is called with three arguments: accumulator, page, and index. The accumulator is a value of any type you choose, but it will contain undefined when reduce is called for the first time. The page argument and index arguments are exactly what they say they are. The reduce function's return value will be passed in as accumulator the next time its called, and the returned promise will resolve to the last value of accumulator.

The for-await-of syntax is part of ES2018. It is available natively in Node starting with v10.0.0. You may be able to use it in earlier JavaScript runtimes by transpiling your source with a tool like Babel. However, the transpiled code will likely sacrifice performance.

Parameters
method

string

the cursor-paginated Web API method to call https://api.slack.com/docs/pagination

options

Record<string, unknown>

options

shouldStop

PaginatePredicate

a predicate that is called with each page, and should return true when pagination can end.

Returns

Promise<void>

Call Signature

paginate<R, A>(
method,
options,
shouldStop,
reduce?): Promise<A>

Defined in: packages/web-api/src/WebClient.ts:433

Iterate over the result pages of a cursor-paginated Web API method. This method can return two types of values, depending on which arguments are used. When up to two parameters are used, the return value is an async iterator which can be used as the iterable in a for-await-of loop. When three or four parameters are used, the return value is a promise that resolves at the end of iteration. The third parameter, shouldStop, is a function that is called with each page and can end iteration by returning true. The fourth parameter, reduce, is a function that is called with three arguments: accumulator, page, and index. The accumulator is a value of any type you choose, but it will contain undefined when reduce is called for the first time. The page argument and index arguments are exactly what they say they are. The reduce function's return value will be passed in as accumulator the next time its called, and the returned promise will resolve to the last value of accumulator.

The for-await-of syntax is part of ES2018. It is available natively in Node starting with v10.0.0. You may be able to use it in earlier JavaScript runtimes by transpiling your source with a tool like Babel. However, the transpiled code will likely sacrifice performance.

Type Parameters

R extends PageReducer<any>

A extends any

Parameters
method

string

the cursor-paginated Web API method to call https://api.slack.com/docs/pagination

options

Record<string, unknown>

options

shouldStop

PaginatePredicate

a predicate that is called with each page, and should return true when pagination can end.

reduce?

PageReducer<A>

a callback that can be used to accumulate a value that the return promise is resolved to

Returns

Promise<A>