Changelog

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.

v2.14.0 (November 30th, 2023)

  • We've updated the CLI to prompt you to request admin approval for an Admin-Approved App using a connector function that is not currently approved for use in your workspace. For more information, refer to Platform permissions control for admins.
  • We've formatted the system and project configs with indents to make editing easier.
  • We've added a SLACK_CONFIG_DIR environment variable to the --config-dir global flag.
  • The uninstall command is now available from the list displayed when using the --help flag.

v2.13.0 (November 16th, 2023)

  • We've added an --all-org-workspace-grants flag to the app list command so you can display all grants instead of only the first three.
  • We've combined 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.
  • We removed the redirect to the 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.
  • We've updated the CLI installer to align the Deno runtime version with the current version supported by the Slack platform.
  • We've updated all deno-reverse-string sample app references to use deno-started-template instead.
  • We fixed a bug to create a usr/local/bin directory if it is missing when installing the CLI.
  • We updated some confusing language related to breaking changes.
  • We fixed a bug that caused an error when any property setting flags were provided along with the --trigger-def flag.
  • We fixed a bug where descriptions and selected template URLs might be mismatched from the displayed list of samples.

v2.12.0 (November 2nd, 2023)

  • We now support npm dependencies in a beta capacity, so you can use the 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.
  • We've updated the slack app list command to display Enterprise grants for multiple workspaces.
  • We fixed a bug that displayed app manifest warnings when there were none.

v2.11.0 (October 26th, 2023)

  • We've updated commands requiring manifest validation (e.g. 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.
  • New error codes for connectors have been added to aid you in troubleshooting.
  • We've added a --file flag to the function distribute command so that you can manage access and distributions with a configuration file instead of multiple commands.

v2.10.0 (October 5th, 2023)

  • We've updated the deploy command to prompt you to select an organization workspace, similarly to the run command. Refer to deploy to Slack for more details.
  • We've added a little more polish to the Admin-Approved Apps flow.
  • We've added support for the apps.certified.install method, coming soon to an API near you!
  • We've implemented a few bug fixes behind the scenes to keep things running smoothly.

v2.9.1 (September 21st, 2023)

  • We now order functions by callback ID for easier sorting when you call the function distribute command.
  • We've formatted and streamlined the install script as well as some of our error descriptions for a smoother, more pleasant experience.

Minimum CLI version (September 19th, 2023)

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.

v2.9.0 (September 8th, 2023)

We now support Slack's new look & feel! For the best experience, we recommend upgrading to CLI version 2.9.0+.

  • Starting on Sept 19th, Slack CLI v2.9.0 is required to login to Slack Enterprise. For everyone else, Slack CLI v1.18.0 is the minimum version.
  • You can now specify which workspace within an Enterprise Grid organization to grant your app access to when you deploy and install your app by using the --org-workspace-grant flag.
  • Sometimes additional admin approval is needed before your app can be installed. We now notify you that pending app approval/denial notifications will come from Slackbot.
  • We added more workflow events to the CLI for improved troubleshooting.
  • We updated the output of our --info flag for a more streamlined experience.
  • You can now skip the workspace selection dialog when you supply an app id via --app and an active token via --token flags.

v2.8.0 (August 24th, 2023)

  • Improved Deno dependency caching.
  • app list no longer requires authentication, and will instead display an unknown app status in cases where no authentication is found.
  • The run, deploy, and delete commands will now resolve organization-level authentication in cases where workspace-level authentication is missing.

v2.7.0 (August 10th, 2023)

  • Added a slack trigger list --type=<string> flag to only list triggers of a specific type:
    • For example, slack trigger list --type=shortcut
    • Supported flag values for --type=<string> are all, shortcut, event, webhook, scheduled, and external.
  • Added flags to provide values for many interactive prompts. Learn more about the flags available by adding --help to any command.
    • For example, slack external-auth add-secret --provider github --secret my-secret-value
  • Updated slack app list to improve displaying apps that you are not authenticated to access:
    • Local apps now display a (local) label
    • Install status is now shown as Status: Unknown
  • Removed an incorrect timestamp found in the Slack debug log file.
  • The Deno SDK v2.2.0 now displays an error in your editor when you accidentally register duplicate primary keys for workflow, function, datastore, customType, event or provider. This helps prevent unexpected behavior at runtime.

v2.6.0 (July 27, 2023)

  • The .github directory will no longer be included in new projects created from one of our sample apps.
  • Updated our support email to feedback@slack.com - email us for assistance if your app returns an internal error code.
  • Using the slack app list command now returns Status: Installed instead of Status: Unknown for an installed app.
  • When using the CLI in a non-interactive environment, such as in a CI pipeline, selection prompts will error and suggest a flag alternative to use instead of hanging indefinitely.
  • Trigger generation prompts will be automatically skipped when using slack run or slack deploy in a non-interactive environment, regardless of how many triggers might exist.
  • Clarified admin approval requirements when installing to a workspace that has Admin-Approved Apps enabled.
  • Socket connections are now gracefully closed when ending a slack run session.
  • Improved typeahead suggestions for the type field of functions and datastores were made in the Deno SDK.

v2.5.1 (July 10, 2023)

  • Fixed a bug to now properly delete the selected app when uninstalling from a workspace.

v2.5.0 (June 29, 2023)

  • Added a confirmation message if you decide not to delete an app when using the slack app delete command.
  • Added a --hide-triggers flag to slack run and slack deploy to prevent retrieving and displaying application triggers.
  • Added a warning to listed trigger info that Slack Connect channels do not support event triggers.
  • Added app collaborators to listed trigger info.
  • Added support to limit paginated results with the trigger list --limit <n> command.
  • Added a prompt for whether you would like to include/exclude app collaborators into the named entities list if you set your trigger's ACL to named_entities. The include-app-collaborators flag will allow you to skip this prompt.
  • Updated the slack activity command to support datastore event and error logs. For more information, refer to logging.
  • When the --token flag is set, background checks for updates will now be automatically disabled.
  • Added support to fall back to a curl install of deno if deno upgrade should fail.
  • The slack logout command now accepts the --workspace flag.
  • We removed the --show-triggers flag from the slack run command, as the command now displays all of your app's triggers and their types.

Deprecation of CLI v1.17.0 and below (June 28, 2023)

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.

v2.4.0 (June 15, 2023)

  • Updated the Linux/macOS installation script to support a CLI version param, -v.
  • Added a -d flag to bypass Deno installation in the Linux/macOS installation script.
  • Updated the Windows installation script to include Alias, Version, SkipDeno, and SkipGit flags.
  • Suggest Windows users open a new terminal after installation to add the Slack CLI to the user's environment PATH.
  • Bumped minimum required Deno version to 1.31.1.
  • Replaced the workspace command with a new app command.
  • Made visible the config-dir global flag.
  • Deprecated auth login's auth flag in favor of token.
  • Updated app list command to display installation status.

v2.3.0 (June 1, 2023)

  • The external-auth remove command now allows you to select a token for deletion.
  • The new 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.
  • The slack auth token and slack auth revoke commands allow you to manage (create and delete) service tokens.
    • The 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.
    • The service token will not be saved to your credentials.json file; instead, it is presented in the prompt for you to copy and paste to your CI/CD pipelines.
    • Once you obtained a service token, you can use slack login --auth <your-service-token> to authorize your Slack CLI.
The service token will not conflict with your regular authentication token; you can continue using your regular authentication token within the Slack CLI while using the service token for your CI/CD pipelines.
  • The new global --token <token> flag allows you to pass the service token used by requests requiring authentication. For example:
    • Install an app: slack install --token <your-service-token>
    • Create a trigger: slack trigger create --token <your-service-token> --app deployed --trigger-def triggers/trigger_def_file.ts
    • Deploy an app: slack deploy --token <your-service-token>
  • Added support for a global --experiment [name,name,...] flag.

v2.2.0 (May 4, 2023)

  • trigger info now also shows who can run the trigger.
  • Added the --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.
  • The datastore query command now supports a cursor argument to help you paginate your results the way you want.
  • Trigger operations will now let you know when an invalid trigger file is being ignored.
  • Improved error reporting and help text.

General availability (April 24, 2023)

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!

v2.1.0 (April 20, 2023)

CLI enhancements

  • Updated login flow instructions to be clearer for new developers.
  • Improved formatting in the trigger_execution log for greater readability.
  • Improved Windows installation script to have more specific error messaging.
  • Updated the slack doctor command to display the local git version.
  • Hid a select few flags that appear when using the slack help command, but not to worry! Those hidden commands are still visible while using slack help -v.
  • Refined text formatting for greater accessibility.

Bug fixes

  • Datastore methods now take an app selection prompt.
  • Remedied a CLI runtime error that would occur when running slack help deno without any other arguments.

v2.0.0 (April 6th, 2023)

  • Added support for TTY devices to remove color and emoji when redirecting output.
  • Added displayed timestamps to the --verbose flag.
  • Simplified the create experience for developers from installation to deployment.
  • Added a hint when running trigger create or trigger list for developers to invite their app to a channel to receive events, and formatted outputs when displaying trigger information.
  • Added support for the error code 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.
  • Renamed the slack cloud command to the slack platform command. For more information, refer to commands.
  • Renamed (dev) with (local) for local apps in the workspace list.
  • Added support for Windows users to install the Slack CLI, Deno, Git, and VSCode with the Deno extension. For more information, refer to the Quickstart.
  • Renamed the slack workspace uninstall command to slack workspace delete.
  • Improved the user experience when using slack login --auth <string> to log in.
  • Added the shorthand -a for the --app flag.
  • Removed the slack auth info command, as the pertinent information is found by using the slack auth list command.
  • Added a slack samples command, which will list the available sample app templates you can use to create a new app.
  • Removed git as a required dependency of installing sample apps.