Your experience while developing next generation Slack apps is largely governed by the SDKs and the CLI. These tools change as the platform changes, and we release new versions regularly. Subscribe to be notified of updates, and let us know how we're doing.
SLACK_CONFIG_DIR
environment variable to the --config-dir
global flag.uninstall
command is now available from the list displayed when using the --help
flag.--all-org-workspace-grants
flag to the app list
command so you can display all grants instead of only the first three.workspace
and org
language into team
; as such, we have added a --team
flag and deprecated the --workspace
flag. Note that this will not affect the usage of workspace or org when it is necessary to distinguish between them; for example, with the hermes auth list
and trigger access
commands.delete
command when running the uninstall
command, so you may now only uninstall an app rather than deleting the app entirely along with all of its data.deno-reverse-string
sample app references to use deno-started-template
instead.usr/local/bin
directory if it is missing when installing the CLI.--trigger-def
flag.npm:
specifier when importing modules for both locally run and deployed apps. For more details about using npm:
and node:
specifiers, refer to Node.js APIs and npm packages.slack app list
command to display Enterprise grants for multiple workspaces.manifest
, deploy
, install
, triggers create
, and triggers run
) to catch errors if a connector is not installed, attempt to install any certified apps related to connectors mentioned in the manifest, and then re-validate the manifest.--file
flag to the function distribute
command so that you can manage access and distributions with a configuration file instead of multiple commands.deploy
command to prompt you to select an organization workspace, similarly to the run
command. Refer to deploy to Slack for more details.apps.certified.install
method, coming soon to an API near you!function distribute
command.Starting today, the Slack API's minimum required CLI version for Enterprise Grid is changing from v1.18.0
to v2.9.0
. If you attempt to log in with an older version, you'll receive a cli_update_required
error from the Slack API.
Run slack upgrade
to get the latest version. Refer to install & authorize for more details about installing the Slack CLI.
We now support Slack's new look & feel! For the best experience, we recommend upgrading to CLI version 2.9.0+.
deploy
and install
your app by using the --org-workspace-grant
flag.--info
flag for a more streamlined experience.--app
and an active token via --token
flags.app list
no longer requires authentication, and will instead display an unknown
app status in cases where no authentication is found.run
, deploy
, and delete
commands will now resolve organization-level authentication in cases where workspace-level authentication is missing.slack trigger list --type=<string>
flag to only list triggers of a specific type:
slack trigger list --type=shortcut
--type=<string>
are all
, shortcut
, event
, webhook
, scheduled
, and external
.--help
to any command.
slack external-auth add-secret --provider github --secret my-secret-value
slack app list
to improve displaying apps that you are not authenticated to access:
(local)
labelStatus: Unknown
workflow
, function
, datastore
, customType
, event
or provider
. This helps prevent unexpected behavior at runtime..github
directory will no longer be included in new projects created from one of our sample apps.feedback@slack.com
- email us for assistance if your app returns an internal error code.slack app list
command now returns Status: Installed
instead of Status: Unknown
for an installed app.slack run
or slack deploy
in a non-interactive environment, regardless of how many triggers might exist.slack run
session.type
field of functions
and datastores
were made in the Deno SDK.slack app delete
command.--hide-triggers
flag to slack run
and slack deploy
to prevent retrieving and displaying application triggers.trigger list --limit <n>
command.named_entities
. The include-app-collaborators
flag will allow you to skip this prompt.slack activity
command to support datastore event and error logs. For more information, refer to logging.--token
flag is set, background checks for updates will now be automatically disabled.curl
install of deno
if deno upgrade
should fail.slack logout
command now accepts the --workspace
flag.--show-triggers
flag from the slack run
command, as the command now displays all of your app's triggers and their types.Breaking change
Beginning June 28, version v1.17.0 and below of the CLI is deprecated. We recommend reinstalling the CLI to get the latest version. Learn more.
-v
.-d
flag to bypass Deno installation in the Linux/macOS installation script.workspace
command with a new app
command.config-dir
global flag.auth
flag in favor of token
.app list
command to display installation status.external-auth remove
command now allows you to select a token for deletion.external-auth select-auth
command allows you to select a unique auth for each of the workflows in an app. This command is mandatory when using new in-code workflows that have a step containing credentialSource DEVELOPER
; that is, every time an in-code workflow is created, this command must be called after the external-auth add
command.slack auth token
and slack auth revoke
commands allow you to manage (create and delete) service tokens.
slack auth token
command allows you to get the slackauthticket
and to copy and paste it into your workspace to exchange for the service token.credentials.json
file; instead, it is presented in the prompt for you to copy and paste to your CI/CD pipelines.slack login --auth <your-service-token>
to authorize your Slack CLI.--token <token>
flag allows you to pass the service token used by requests requiring authentication. For example:
slack install --token <your-service-token>
slack trigger create --token <your-service-token> --app deployed --trigger-def triggers/trigger_def_file.ts
slack deploy --token <your-service-token>
--experiment [name,name,...]
flag.trigger info
now also shows who can run the trigger.--no-color
flag, which removes all ANSI sequences for color as well
as emojis, giving you plain text output from the CLI that's perfect for piping
to a text file.datastore query
command now supports a cursor
argument to help you
paginate your results the way you want.Today we're announcing that the next generation Slack platform–which provides a faster, more flexible way to build automations on top of Slack–is generally available to developers. The platform's overhauled architecture gives developers more ways to build, code, and ship custom apps and workflows more quickly and easily in an environment that's both secure and compliant. Read the announcement or follow the Quickstart to get started today!
CLI enhancements
login
flow instructions to be clearer for new developers.trigger_execution
log for greater readability.slack doctor
command to display the local git
version.slack help
command, but not to worry! Those hidden commands are still visible while using slack help -v
.Bug fixes
slack help deno
without any other arguments.--verbose
flag.create
experience for developers from installation to deployment.trigger create
or trigger list
for developers to invite their app to a channel to receive events, and formatted outputs when displaying trigger information.message_limit_exceeded
. The error code is included in the following endpoints when a free team has reached their message limit: callbacks.chat/postMessage, chat/postEphemeral, chat/postMessage, chat/scheduleMessage, chat/shareMessage, files/share, and drafts/create. For more information, refer to Usage limits for free workspaces.slack cloud
command to the slack platform
command. For more information, refer to commands.(dev)
with (local)
for local apps in the workspace list.slack workspace uninstall
command to slack workspace delete
.slack login --auth <string>
to log in.-a
for the --app
flag.slack auth info
command, as the pertinent information is found by using the slack auth list
command.slack samples
command, which will list the available sample app templates you can use to create a new app.