Changelog

Your experience while developing automations 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.19.0 (March 11th, 2024)

  • We've added a new Time To Live (TTL) feature to datastores! Refer to Delete items automatically for more details.
  • We fixed an issue so that any GetHooks errors display properly.
  • As part of the Deno Slack SDK v2.7.0 release, we've added new Slack functions for Canvases! Refer to the Canvas section of the Slack functions catalog for more details.

v2.18.0 (February 22nd, 2024)

The minimum supported PowerShell version as of this release is v6.0. If you attempt to use an older version of PowerShell, you may encounter errors reading the Slack Configuration file (slack.json) or running the get hooks hook.

  • We've added the ability to put, get, and delete items in bulk in a datastore. Refer to Create or replace items with put and bulkPut, Retrieve items with get and bulkGet, and Delete items with delete and bulkDelete, respectively.
  • We've added the ability to import to and export from datastores. Refer to Datastore commands for more details.
  • We've added a warning when creating an app from a sample app when the sample app may not have come from a trusted source.
    • You can disable this warning temporarily by running the slack create command with the --force flag.
    • You can disable this warning permanently by either selecting don't ask again when prompted, or by setting the trust_unknown_sources property in your config.json file.
  • We've fixed an issue so can now use CTRL-C to unhide your cursor when a spinner displays after running slack deploy.
  • We've enhanced some error messages and we've improved highlighting matching for help commands.

v2.17.1 (February 7th, 2024)

  • We added an enhancement to provide the SLACK_APP_TOKEN and SLACK_BOT_TOKEN environment variables when you run your app.
  • We now install development dependencies for apps on the Node.js runtime when creating a new app to ensure @slack/cli-hooks is installed.
  • We've fixed an issue by formatting paths with OS-specific dividers in the slack create command.

v2.17.0 (January 25th, 2024)

  • We've improved how the CLI gathers environment variables.

v2.16.0 (January 11th, 2024)

  • We now display the workflow name for errors returned in the CLI.
  • We now return an error if credentials aren't found for a selected app when using the slack app command.

v2.15.0 (December 14th, 2023)

  • We've updated the "choose a workspace to grant access" prompt to sort by team name rather than team ID.
  • We've deprecated the deno command and removed its listing from the help command. The deno command is slated to be removed completely in an upcoming release.
  • Endpoints at api.slack.com are no longer blocked by a permission error for local apps.
  • We now have better error handling when appending a (local) tag to the display name of local apps.
  • We've removed some extra blank lines and debug information from command outputs for a cleaner look and faster feel.
  • We've provided prompts for possible trigger IDs for trigger commands that need them.

Happy last release of the year!

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 the new look & feel of Slack! 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.