Welcome to the workspace token-based Slack app developer preview, still under active development.
This is a preview of the next generation of Slack apps. We want Slack apps to be ever easier to discover, trial, install, and upgrade and this new token type and permission model is the vehicle to that future.
Read our announcement to learn more about our motivation behind these changes and the benefits delivered to users and developers.
Your workspace token-based Slack apps cannot yet be distributed to other teams via the directory. They're just for your personal enjoyment, development, and exploration. Stay tuned.
We open-sourced Lunch Train and now it works with workspace tokens.
Lunch Train is a PHP app that helps teams plan lunch outings together.
slackapi/lunchtrainto understand how the sandwich is made and adapt it for your team's food, fun, or funky preferences.
There may be no free lunch but at least there's a free Lunch Train. All aboard!
Workspace tokens that power these new Slack apps work just like you're used to. Except they don't, so you'll want to catch up with this fresh documentation:
Look for these notices amidst content about different types of tokens for workspace-token specific information:
This treatment appears on OAuth scopes and Web API methods that support workspace tokens. Let it guide your way.
This feature only applies to the workspace token-based Slack app developer preview, currently under active development.
Workspace token-based Slack apps bring a number of refinements to the original model:
The launch of this developer preview is only the beginning.
Coming soon to a workspace token near you:
Longer term, we'll provide clarity around:
For now, workspace token-based Slack apps aren't ready for distribution in the app directory.
Keep track of where we're going:
/feedin your favorite Slack channel.
Send us feedback! We love feedback! Email us at firstname.lastname@example.org.
As with any nascent far-reaching platform feature, workspace tokens have a few bugs and unimplemented but planned features.
|Enterprise grid||Workspace token-based Slack apps cannot yet be installed on or created within Enterprise Grid workspaces. If you're part of a Grid, create a test team to work with the developer preview.|
|Chat||New! Workspace tokens now use the new
|Files||New! Your workspace token-based app can read and write files with the
|OAuth||Workspace tokens cannot yet call the legendary
|OAuth||Workspace token-based apps' approved OAuth scopes are not listed in HTTP headers like
|Documentation||Some of the OAuth scopes listed as supporting workspace tokens do not actually support those tokens yet. Some methods claiming workspace token support don't support them yet. Personal experience will tell you for sure.|
Find a new issue or have a question? Send us email to email@example.com.