Class: WebClient
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?, __namedParameters?): WebClient
Parameters
• token?: string
An API token to authenticate/authorize with Slack (usually start with xoxp, xoxb)
• __namedParameters?: WebClientOptions = {}
Returns
Overrides
Defined in
packages/web-api/src/WebClient.ts:200
Properties
admin
readonly admin: object;
analytics
analytics: object;
analytics.getFile
getFile: MethodWithRequiredArgument<AdminAnalyticsGetFileArguments, AdminAnalyticsGetFileResponse>;
Description
Retrieve analytics data for a given date, presented as a compressed JSON file.
See
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
Defined in
packages/web-api/src/methods.ts:562
api
readonly api: object;
test
test: Method<object, ApiTestResponse>;
Type declaration
error?
optional error: string;
Description
Error response to return.
Description
Checks API calling code.
See
Inherited from
Defined in
packages/web-api/src/methods.ts:1327
apps
readonly apps: object;
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
Inherited from
Defined in
packages/web-api/src/methods.ts:1335
auth
readonly auth: object;
revoke
revoke: Method<TokenOverridable & object, AuthRevokeResponse>;
Description
Revokes a token.
See
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
Defined in
packages/web-api/src/methods.ts:1397
bookmarks
readonly bookmarks: object;
add
add: MethodWithRequiredArgument<BookmarksAddArguments, BookmarksAddResponse>;
Description
Add bookmark to a channel.
See
edit
edit: MethodWithRequiredArgument<BookmarksEditArguments, BookmarksEditResponse>;
Description
Edit bookmark.
See
list
list: MethodWithRequiredArgument<BookmarksListArguments, BookmarksListResponse>;
Description
List bookmarks for a channel.
See
remove
remove: MethodWithRequiredArgument<BookmarksRemoveArguments, BookmarksRemoveResponse>;
Description
Remove bookmark from a channel.
See
bookmarks.remove API reference.
Inherited from
Defined in
packages/web-api/src/methods.ts:1413
bots
readonly bots: object;
info
info: Method<TokenOverridable & OptionalTeamAssignable & object, BotsInfoResponse>;
Description
Gets information about a bot user.
See
Inherited from
Defined in
packages/web-api/src/methods.ts:1436
calls
readonly calls: object;
add
add: MethodWithRequiredArgument<CallsAddArguments, CallsAddResponse>;
Description
Registers a new Call.
See
end
end: MethodWithRequiredArgument<CallsEndArguments, CallsEndResponse>;
Description
Ends a Call.
See
info
info: MethodWithRequiredArgument<CallsInfoArguments, CallsInfoResponse>;
Description
Returns information about a Call.
See
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
Inherited from
Defined in
packages/web-api/src/methods.ts:1444
canvases
readonly canvases: object;
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
sections
sections: object;
sections.lookup
lookup: MethodWithRequiredArgument<CanvasesSectionsLookupArguments, CanvasesSectionsLookupResponse>;
Description
Find sections matching the provided criteria.
See
canvases.sections.lookup API reference.
Inherited from
Defined in
packages/web-api/src/methods.ts:1478
chat
readonly chat: object;
delete
delete: MethodWithRequiredArgument<ChatDeleteArguments, ChatDeleteResponse>;
Description
Deletes a message.
See
deleteScheduledMessage
deleteScheduledMessage: MethodWithRequiredArgument<ChatDeleteScheduledMessageArguments, ChatDeleteScheduledMessageResponse>;
Description
Deletes a pending scheduled message from the queue.
See
chat.deleteScheduledMessage API reference.
getPermalink
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
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.
scheduleMessage
scheduleMessage: MethodWithRequiredArgument<ChatScheduleMessageArguments, ChatScheduleMessageResponse>;
Description
Schedules a message to be sent to a channel.
See
chat.scheduleMessage 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.
unfurl
unfurl: MethodWithRequiredArgument<ChatUnfurlArguments, ChatUnfurlResponse>;
Description
Provide custom unfurl behavior for user-posted URLs.
See
update
update: MethodWithRequiredArgument<ChatUpdateArguments, ChatUpdateResponse>;
Description
Updates a message.
See
Inherited from
Defined in
packages/web-api/src/methods.ts:1518
conversations
readonly conversations: object;
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.
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
Defined in
packages/web-api/src/methods.ts:1582
dialog
readonly dialog: object;
open
open: MethodWithRequiredArgument<DialogOpenArguments, DialogOpenResponse>;
Description
Open a dialog with a user.
See
Inherited from
Defined in
packages/web-api/src/methods.ts:1767
dnd
readonly dnd: object;
endDnd
endDnd: Method<TokenOverridable, DndEndDndResponse>;
Description
Ends the current user's Do Not Disturb session immediately.
See
endSnooze
endSnooze: Method<TokenOverridable, DndEndSnoozeResponse>;
Description
Ends the current user's snooze mode immediately.
See
info
info: Method<TokenOverridable & OptionalTeamAssignable & object, DndInfoResponse>;
Description
Retrieves a user's current Do Not Disturb status.
See
setSnooze
setSnooze: MethodWithRequiredArgument<DndSetSnoozeArguments, DndSetSnoozeResponse>;
Description
Turns on Do Not Disturb mode for the current user, or changes its duration.
See
teamInfo
teamInfo: MethodWithRequiredArgument<DndTeamInfoArguments, DndTeamInfoResponse>;
Description
Retrieves the Do Not Disturb status for up to 50 users on a team.
See
Inherited from
Defined in
packages/web-api/src/methods.ts:1775
emoji
readonly emoji: object;
list
list: Method<TokenOverridable & object, EmojiListResponse>;
Description
Lists custom emoji for a team.
See
Inherited from
Defined in
packages/web-api/src/methods.ts:1803
files
readonly files: object;
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
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
list
list: MethodWithRequiredArgument<FilesListArguments, FilesListResponse>;
Description
List files for a team, in a channel, or from a user with applied filters.
See
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
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
Defined in
packages/web-api/src/methods.ts:1811
functions
readonly functions: object;
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
Defined in
packages/web-api/src/methods.ts:1920
migration
readonly migration: object;
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
Defined in
packages/web-api/src/methods.ts:1939
oauth
readonly oauth: object;
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
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
Defined in
packages/web-api/src/methods.ts:1947
openid
readonly openid: object;
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
Defined in
packages/web-api/src/methods.ts:1968
pins
readonly pins: object;
add
add: MethodWithRequiredArgument<PinsAddArguments, PinsAddResponse>;
Description
Pins an item to a channel.
See
list
list: MethodWithRequiredArgument<PinsListArguments, PinsListResponse>;
Description
Lists items pinned to a channel.
See
remove
remove: MethodWithRequiredArgument<PinsRemoveArguments, PinsRemoveResponse>;
Description
Un-pins an item from a channel.
See
Inherited from
Defined in
packages/web-api/src/methods.ts:1986
reactions
readonly reactions: object;
add
add: MethodWithRequiredArgument<ReactionsAddArguments, ReactionsAddResponse>;
Description
Adds a reaction to an item.
See
get
get: MethodWithRequiredArgument<ReactionsGetArguments, ReactionsGetResponse>;
Description
Gets reactions for an item.
See
list
list: Method<ReactionsFull & TokenOverridable & TraditionalPagingEnabled & CursorPaginationEnabled & OptionalTeamAssignable & object, ReactionsListResponse>;
Description
List reactions made by a user.
See
remove
remove: MethodWithRequiredArgument<ReactionsRemoveArguments, ReactionsRemoveResponse>;
Description
Removes a reaction from an item.
See
reactions.remove API reference.
Inherited from
Defined in
packages/web-api/src/methods.ts:2004
reminders
readonly reminders: object;
add
add: MethodWithRequiredArgument<RemindersAddArguments, RemindersAddResponse>;
Description
Creates a reminder.
See
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
list
list: Method<TokenOverridable & OptionalTeamAssignable, RemindersListResponse>;
Description
Lists all reminders created by or for a given user.
See
Inherited from
Defined in
packages/web-api/src/methods.ts:2029
rtm
readonly rtm: object;
connect
connect: Method<TokenOverridable & object, RtmConnectResponse>;
Description
Starts a Real Time Messaging session.
See
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
Inherited from
Defined in
packages/web-api/src/methods.ts:2057
search
readonly search: object;
all
all: MethodWithRequiredArgument<SearchAllArguments, SearchAllResponse>;
Description
Searches for messages and files matching a query.
See
files
files: MethodWithRequiredArgument<SearchFilesArguments, SearchFilesResponse>;
Description
Searches for files matching a query.
See
messages
messages: MethodWithRequiredArgument<SearchMessagesArguments, SearchMessagesResponse>;
Description
Searches for messages matching a query.
See
search.messages` API reference.
Inherited from
Defined in
packages/web-api/src/methods.ts:2071
slackApiUrl
readonly slackApiUrl: string;
The base URL for reaching Slack's Web API. Consider changing this value for testing purposes.
Defined in
packages/web-api/src/WebClient.ts:143
stars
readonly stars: object;
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
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
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
Inherited from
Defined in
packages/web-api/src/methods.ts:2313
team
readonly team: object;
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
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
Defined in
packages/web-api/src/methods.ts:2089
token?
readonly optional token: string;
Authentication and authorization token for accessing Slack Web API (usually begins with xoxp or xoxb)
Defined in
packages/web-api/src/WebClient.ts:148
tooling
readonly tooling: object;
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
Defined in
packages/web-api/src/methods.ts:2160
usergroups
readonly usergroups: object;
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
Defined in
packages/web-api/src/methods.ts:2170
users
readonly users: object;
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
info
info: MethodWithRequiredArgument<UsersInfoArguments, UsersInfoResponse>;
Description
Gets information about a user.
See
list
list: MethodWithRequiredArgument<UsersListArguments, UsersListResponse>;
Description
Lists all users in a Slack team.
See
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
setPresence
setPresence: MethodWithRequiredArgument<UsersSetPresenceArguments, UsersSetPresenceResponse>;
Description
Manually sets user presence.
See
users.setPresence API reference.
Inherited from
Defined in
packages/web-api/src/methods.ts:2213
views
readonly views: object;
open
open: MethodWithRequiredArgument<ViewsOpenArguments, ViewsOpenResponse>;
Description
Open a view for a user.
See
publish
publish: MethodWithRequiredArgument<ViewsPublishArguments, ViewsPublishResponse>;
Description
Publish a static view for a user.
See
push
push: MethodWithRequiredArgument<ViewsPushArguments, ViewsPushResponse>;
Description
Push a view onto the stack of a root view.
See
update
update: MethodWithRequiredArgument<ViewsUpdateArguments, ViewsUpdateResponse>;
Description
Update an existing view.
See
Inherited from
Defined in
packages/web-api/src/methods.ts:2283
workflows
readonly workflows: object;
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
Defined in
packages/web-api/src/methods.ts:2337
Methods
apiCall()
apiCall(method, options): Promise<WebAPICallResult>
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
Defined in
packages/web-api/src/WebClient.ts:268
filesUploadV2()
filesUploadV2(options): Promise<WebAPICallResult & object>
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
Defined in
packages/web-api/src/WebClient.ts:446
paginate()
paginate(method, options)
paginate(method, options?): AsyncIterable<WebAPICallResult>
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>
Defined in
packages/web-api/src/WebClient.ts:354
paginate(method, options, shouldStop)
paginate(
method,
options,
shouldStop): Promise<void>
Parameters
• method: string
• options: Record<string, unknown>
• shouldStop: PaginatePredicate
Returns
Promise<void>
Defined in
packages/web-api/src/WebClient.ts:355
paginate(method, options, shouldStop, reduce)
paginate<R, A>(
method,
options,
shouldStop,
reduce?): Promise<A>
Type Parameters
• R extends PageReducer<any>
• A extends any
Parameters
• method: string
• options: Record<string, unknown>
• shouldStop: PaginatePredicate
• reduce?: PageReducer<A>
Returns
Promise<A>