Skip to main content

admin.apps.restricted.list method

Welcome to the new home of Slack developer docs!

We're still building and not all features are available quite yet. Enjoy this peek into the future!

Not ready for the future? Return to the past at api.slack.com.

Usage info

This App Management API method lists apps restricted from installation on a workspace or org.

This method requires an admin.* scope. It's obtained through the normal OAuth process, but there are a few additional requirements. The scope must be requested by an Enterprise Grid admin or owner, and the OAuth install must take place on the entire Grid org, not an individual workspace. See the admin.apps:read method for more detailed instructions.

enterprise_id and team_id cannot be used together.
  • Passing enterprise_id will return the list of org-wide approved apps.
  • Passing team_id will return the apps approved for that specific workspace.

Response

The developer_type in each app helpfully describes its origin.

  • internal: the app was developed as part of this Enterprise Grid or workspace.
  • third_party: the app was developed by a third party, such as (but not limited to) those found in the Slack Marketplace.
  • slack: the app was built with love by Slack. Hello!