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.20.1 (March 21st, 2024)
- We fixed an issue to make our releases run more smoothly. Nothing to see here!
v2.20.0 (March 21st, 2024)
- We've added a new feature for counting datastore items. Refer to Counting items in a datastore for more details.
- We added a new feature to query named datastores from a flag instead of an expression. For example β before:
$ slack datastore get '{"datastore": "todos", "id": "42"}'
and after:
$ slack datastore get --datastore tasks '{"id": "42"}'
- We now include a remediation message for the
not_authed
error that explains how to log in and authorize the Slack CLI.
- Users can now request app approval at the workspace level on Enterprise Grid.
- We now include the error code in event payloads to logstash.
- We fixed a bug to output a link if opening the URL in a browser fails.
- We fixed a bug to catch missing hooks from a command; the initialization error is now included in the debug outputs. This allows any command to be run from a project directory without immediately posting an error.
- We fixed a bug to remove ANSI escape sequences from the debug log outputs for an improved grepping experience.
- We fixed a bug to verify that deprecated flags are properly substituted.
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.