Below is a table that highlights these differences.Ībove, “channels” refers to all channel-like object types, including public channels, private channels, direct messages, and multi-party direct messages. The Discovery API’s methods are similar to the Web API’s but include a subset of the available actions with a broader range of access. Slack’s Discovery API guide suggests requesting only discovery:read for eDiscovery use cases, while including discovery:write if the app requires DLP functionality. An Enterprise app only has two permission levels available - discovery:read, and discovery:write. For example, the scopes users:read, users:read.email, channels:read, and more. Workspace apps can request a wide range of granular permissions, which can be combined to achieve an app’s desired level of access. The permissions available vary between the two types of apps. Resources such as channels can be shared across workspaces in the grid. Slack achieves this with an extra layer above workspaces called ' Enterprise Grid' that the workspaces are grouped within. On the other hand, a Slack Enterprise app can access all resources in multiple workspaces within that Enterprise account using a single access token, as well as resources shared among those workspaces.

If that user or bot connects to multiple workspaces, the app requires a separate access token to access data in each of those workspaces.

A workspace app uses an access token to access resources such as channels, messages, files, and users in a single workspace. The clearest one is the scope of accessible resources. In this article, we’ll explore some of the differences in the capabilities of these two APIs.Īpps connecting to Slack’s Discovery API encounter some key differences from the Web API. For example, in addition to the general workspace-based Web API, Slack also has a separate set of Discovery and Audit APIs to work with Slack Enterprise. Slack includes multiple APIs to access different types of content within various editions of Slack.

Slack web api