Release: Slack CLI v3.9.1
Version 3.9.1 of the developer tools for the Slack platform is here!
We made a few updates behind the scenes to keep things running smoothly.
Version 3.9.1 of the developer tools for the Slack platform is here!
We made a few updates behind the scenes to keep things running smoothly.
Version 3.9.0 of the developer tools for the Slack platform has arrived!
entity_types are now gathered when reading an app manifest.Version 3.8.1 of the developer tools for the Slack platform has arrived!
Version 3.8.0 of the developer tools for the Slack platform has arrived!
slack samples --list command. The --language flag may also be useful in filtering the resulting outputs.--branch and --template flags for the slack samples command. We recommend using the slack create command with these options going forward.hooks.json can now be found in our documentation for reference and details about how various commands can be customized with the Slack CLI to interact with your project.Version 3.7.0 of the developer tools for the Slack platform has arrived!
$HOME/.local/bin path if installing to the /usr/local/bin path causes an error. Additional $PATH setup may be required and is output as needed. The $HOME/.local/bin path adheres to the emerging XDG specification.features.search when gathering an app manifest.Version 3.6.1 of the developer tools for the Slack platform is here!
deno runtime is no longer installed with the Slack CLI installation script. We recommend installing deno separately and configuring CI systems as needed for app development (such as for ROSI apps).Version 3.6.0 of the developer tools for the Slack platform is joining the summer fun!
runtime_not_found error code that will appear when a hook script cannot be found because the runtime for a project wasn't found during execution.slack install command to create and install new Bolt Framework apps that are configured to use app settings as the source of truth (i.e., remote manifest).slack doctor command according to an alphabetized list of team domains.Version 3.5.2 of the developer tools for the Slack platform has landed!
deno as part of the installation. We recommend installing deno separately and configuring CI systems as needed for app development (such as for ROSI apps).sdk_hook_not_found error now provides a link to the Deno starter template hooks.json file as a working example.Version 3.5.1 of the developer tools for the Slack platform is here!
Version 3.5.0 of the developer tools for the Slack platform is here!
slack samples command, and can be filtered using the --language flag.slack samples command with the provided app name.slack run command exited with an error if activity logs failed to stream. Now, retries are attempted for those missed logs.Version 3.4.0 of the developer tools for the Slack platform is here!
slack upgrade command will now automatically detect your macOS architecture and install an Intel or an Apple Silicon binary.v2.15.1 of the Deno Slack SDKv1.4.0 of the Deno Slack Hooksv1.1.3 of the Deno Slack RuntimeVersion 3.3.0 of the developer tools for the Slack platform has arrived!
arm64 build for developers upgrading..git within the URL, the template would fail to be cloned (for example, when running the slack create --template https://github.com/slack-samples/example.git.project.git command).source using the flag for the slack manifest info command now takes precedence to project configurations, which are used to determine the default source.Version 3.2.0 of the developer tools for the Slack platform is here!
project (local) and app settings (remote). You'll see these changes in the slack create, slack init, and slack app link <id> commands, for example.slack app settings command. Bolt developers with a remote manifest source managed within app settings may find this useful for discovering new features or making updates.slack app link and slack app list commands shown when running the slack app --help command now use the entire command in order to prevent potential aliasing errors.Version 3.1.0 of the developer tools for the Slack platform has sprouted!
slack app link command to work with apps that have a local manifest source.slack feedback command to display a prompt for Slack CLI feedback: now you can ask questions, submit issues, or suggest features for the Slack CLI through GitHub Issues.slack feedback --name platform-improvements command has been replaced with slack feedback --name slack-platform. You can continue to use the --name platform-improvements flag until the next major version release.slack feedback command error message to account for a missing --name <id> flag and to clarify that the name is specified as a flag. You should now see: Please provide a --name flag or remove the --no-prompt flag.Version 3.0.5 of the developer tools for the Slack platform has bloomed!
slack upgrade command inside a project directory, the output now notes whether the latest SDK versions were checked.Version 3.0.4 of the developer tools for the Slack platform is here!
hooks.json error message to use a working, valid URL.Version 3.0.2 of the developer tools for the Slack platform is here!
slack version command to include additional descriptive information and examples when using the --help flag.slack feedback command to point to the home of our new and improved documentation on docs.slack.dev!Slack CLI v3.0.1 delivers a handful of small improvements thanks to our developer community feedback.
--token flag and it'll work when combined with the --app and --team flags.--app flag to use the specified app and it'll work when combined with the --team flag.Version 3.0.0 of the developer tools for the Slack automations platform is here, with lots of goodies for you!
slack.json file to .slack/hooks.json, and continue to support slack.json for existing projects. There is now a warning shown in --verbose output to encourage projects to migrate their slack.json to .slack/hooks.json.invalid_app_directory error from any commands run in nested project directories, and now search for the required slack.json file in the project's configuration. We also now also check for this file at .slack/hooks.json.slack create and slack samples, to be sub-commands of the slack project command (they remain aliased as top-level commands though, so there is no change to the user experience).slack doctor command to display the manifest.source value, which will be either local or remote.slack create command with a new create journey that allows you to choose between different types of apps for Bolt for JavaScript, Bolt for Python, and Deno.slack init command, which will initialize an existing Bolt for JavaScript, Bolt for Python, or Deno project with Slack CLI support.--no-color flag.slack collaborators and slack manifest commands.slack run command encountered an error; we now exit the slack run command if this happens.Version 2.33.0 of the developer tools for the Slack automations platform will be your valentine!
slack manifest command is run.slack.Version 2.32.1 of the developer tools for the Slack automations platform has arrived!
In the Deno Slack Hooks 1.3.2 release, we've improved the bundling used for the slack deploy command to address some issued encountered with npm imports.
We fixed a bug to skip the hosted app pre-run check when the --force flag is used.
Version 2.32.0 of the developer tools for the Slack automations platform is here!
slack env commands. We also added error messaging to these commands when the app being referenced is not an app created using the Deno Slack SDK.slack env remove command now exits without erroring when there are no environment variables to remove.slack datastore commands.slack external-auth subcommands with Bolt apps.source errors that may have caused confusion; they have been replaced with more helpful messaging.Version 2.31.0 of the developer tools for the Slack automations platform has landed!
We fixed a bug that would display errors when the slack run command was interrupted during app selection. The fix also includes an org_grant_exists error, which is raised if an attempt is made to grant installation permission to another workspace when your app has already been granted one.
Boo! Version 2.30.1 of the developer tools for the Slack automations platform has sneaked up behind you.
We fixed a bug such that expired tokens will now be removed from your local credentials, and the token_expired error will be logged when debugging if returned when using the slack logout command. No tricks, only treats!
Version 2.30.0 of the developer tools for the Slack automations platform has spookily appeared!
slack deploy now respects use of the --force flag. We also fixed a few other bugs related to app manifest validation to make things run more smoothly.slack create command will use either the absolute or relative path provided when creating your app.Version 2.29.2 of the developer tools for the Slack automations platform is hot off the press!
slack login command, the Slack CLI will now suggest also running the slack app list command. When logging in outside of a project directory, the Slack CLI will continue to suggest running the slack create command to create a new project.Version 2.29.1 of the developer tools for the Slack automations platform has arrived!
pwsh to powershell for better backwards compatibility.--source flag with the manifest info command. The flag can be set to either project or remote.npm install command.--workspace flag recommendation with a --team flag recommendation.In the Deno Slack API 2.8.0 release, we've added an event_timestamp property to all event trigger data objects. Refer to the event response object for more details.
Version 2.28.0 of the developer tools for the Slack automations platform has landed!
We made a few updates behind the scenes to keep things running smoothly.
Version 2.27.1 of the developer tools for the Slack automations platform has made a splash!
SLACK_APP_TOKEN or the SLACK_BOT_TOKEN does not match its installed value.In the Deno Slack API 2.7.0 release, we've added support for the following API methods:
In the Deno Slack API 2.6.0 release, we've added support for the following Slack Connect API methods:
In the Deno Slack API 2.5.0 release, we've added support for the following Canvas API methods:
Version 2.26.0 of the developer tools for the Slack automations platform is here!
datastore count Slack CLI command by adding a default for an empty query expression if one isn't provided.In the Deno Slack SDK 2.12.0 release, we've added the add_bookmark Slack function and the team_id type. In addition, you can now pass the optional team_id parameter to the create_channel and create_usergroup Slack functions.
Version 2.25.0 of the developer tools for the Slack automations platform is kicking off the summer fun!
apps.json file with app IDs for your existing apps using the slack app link command. Refer to app commands for more details.slack collaborator add, slack collaborator list, and slack collaborator remove commands.slack create command. We also now suggest installing project dependencies if an error occurs when running this command.slack manifest validate command.Version 2.24.0 of the developer tools for the Slack automations platform has landed!
We've renamed the function distribute command to function access (however, the distribute subcommand has been added as an alias so you can still use function distribute). Refer to custom function access for more details.
We've fixed several bugs that address some messaging, formatting, and emoji in the CLI for easier reading.
In the Deno Slack SDK 2.11.0 release, we've added a new Share Canvas in Thread Slack function.
Version 2.23.0 of the developer tools for the Slack automations platform is here!
SLACK_API_URL environment variable to the preferred API host used in the auth process.slack doctor command.Version 2.22.0 of the developer tools for the Slack automations platform is here!
team_access_not_granted error when redeploying an app.outgoing_domains attribute within an app's manifest.slack create.In the Deno Slack SDK 2.10.0 and Deno Slack API 2.4.0 releases, we added support for the all_resources event for event triggers. Refer to scoping channel-based event triggers for more details.
Version 2.21.0 of the developer tools for the Slack automations platform has sprung!
doctor hook. To enjoy the improved slack doctor command experience, existing Deno Slack SDK-based apps must have their deno-slack-hooks dependency upgraded to the latest version (v1.3.0).get-manifest hook when attempting to get a manifest rather than checking for a slack.yaml file, we now surface any errors that are returned when getting the manifest.In the Deno Slack SDK v2.9.0 release, the invite_user_to_channel built-in function makes the user_ids parameter optional rather than required. In addition, a usergroup_ids parameter was added, allowing you to invite entire user groups.
Versions 2.20.0 and 2.20.1 of the developer tools for the Slack automations platform have landed!
$ slack datastore get '{"datastore": "todos", "id": "42"}'
use:
$ slack datastore get --datastore tasks '{"id": "42"}'
not_authed error that explains how to log in and authorize the Slack CLI.Version 2.19.0 of the developer tools for the Slack automations platform has joined the stage!
GetHooks errors display properly.The Deno Slack SDK v2.7.0 release brings new Slack functions for Canvases!
Refer to the Canvas section of the Slack functions catalog for more details.
Version 2.18.0 of the developer tools for the Slack automations platform has joined the party!
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.put and bulkPut, Retrieve items with get and bulkGet, and Delete items with delete and bulkDelete, respectively.slack create command with the --force flag.trust_unknown_sources property in your config.json file.slack deploy.Version 2.17.1 of the developer tools for the Slack automations platform is hot off the press!
SLACK_APP_TOKEN and SLACK_BOT_TOKEN environment variables when you run your app.@slack/cli-hooks is installed.slack create command.Version 2.17.0 of the developer tools for the Slack automations platform has landed!
We've improved how the CLI gathers environment variables.
New year, new version (2.16.0) of the developer tools for the Slack automations platform!
We now display the workflow name for errors returned in the CLI, and return an error if credentials aren't found for a selected app when using the slack app command.
Version 2.15.0 of the developer tools for the Slack automations platform is home for the holidays!
deno command and removed its listing from the help command. The deno command is slated to be removed completely in an upcoming release.api.slack.com are no longer blocked by a permission error for local apps.(local) tag to the display name of local apps.Version 2.14.0 of the developer tools for the Slack automations platform is here!
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.Version 2.13.0 of the developer tools for the Slack automations platform has landed!
--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.Hot on the heels of last week's release, version 2.12.0 of the developer tools for the Slack automations platform is here!
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.Version 2.11.0 of the developer tools for the Slack automations platform has spookily appeared!
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 (renamed to function access) so that you can manage access and distributions with a configuration file instead of multiple commands.Version 2.10.0 of the developer tools for the Slack automations platform has entered the chat! We've updated the deploy command to prompt you to select an organization workspace, similar to the run command. We also added a little more polish to the Admin-Approved Apps flow, added support for the apps.certified.install method (coming soon to an API near you!), and implemented a few bug fixes behind the scenes to keep things running smoothly.
Version 2.9.1 of the developer tools for the Slack automations platform is here! We now order functions by callback ID for easier sorting when you call the function distribute command (renamed to function access). We've also formatted and streamlined the install script and some of our error descriptions for a smoother, more pleasant experience.
Version 2.9.0 of the developer tools for the Slack automations platform has landed!
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.Version 2.8.0 of the developer tools for the Slack automations platform has arrived!
app list command 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.Version 2.7.0 of the developer tools for the Slack automations platform has arrived!
slack trigger list --type=<string> flag to only list triggers of a specific type: For example, slack trigger list --type=shortcut. We've also supported flag values for --type=<string> are all, shortcut, event, webhook, scheduled, and external.--help to any command. For example, slack external-auth add-secret --provider github --secret my-secret-value.slack app list command to improve displaying apps you are not authenticated to access. For example, local apps now display a (local) label and install status is now shown as Status: Unknown.workflow, function, datastore, customType, event or provider. This helps prevent unexpected behavior at runtime.Version 2.6.0 of the developer tools for the Slack automations platform has arrived!
.github directory will no longer be included in new projects created from one of our sample apps.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 Slack SDK.Version 2.5.1 fixes a bug to now properly delete the selected app when uninstalling it from a workspace.
Version 2.5.0 of the developer tools for the Slack automations platform is hot off the press!
slack app delete command.--hide-triggers flag to the slack run and slack deploy commands 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.Version 2.4.0 of the developer tools for the Slack automations platform is now available!
-v.-d flag to bypass Deno installation in the Linux/macOS installation script.1.31.1.workspace command with a new app command.config-dir global flag visible.auth flag in favor of token.app list command to display installation status.Version 2.3.0 of the developer tools for the Slack automations platform has arrived!
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 coded workflows that have a step containing credentialSource DEVELOPER; that is, every time a coded 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 service tokens.slack auth token command allows you to get the slackauthticket and 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 the slack login --auth <your-service-token> command 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.--token <token> flag allows you to pass the service token used by requests requiring authentication. For example, to install an app, use: slack install --token <your-service-token>. To create a trigger, use: slack trigger create --token <your-service-token> --app deployed --trigger-def triggers/trigger_def_file.ts. To deploy an app, use: slack deploy --token <your-service-token>--experiment [name,name,...] flag.Version 2.2.0 of the developer tools for our beta Slack platform has landed!
trigger info command now also shows who has permissions to 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 Slack automations 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.
We released version v2.1.0 of the developer tools for our Slack platform beta. Changes include better error messages, including the local Git version with the slack doctor command, paring down which commands are visible with slack help to only what is applicable for developers, and more.
We released version v1.21.0 of the developer tools for our Slack platform beta. Changes include improved ergonomics around trigger access management and added a new command to export form responses to CSV, both within the CLI, updates to the default manifest, and more.
We released v1.20.0 of the developer tools for our Slack platform beta. Changes include a number of user-requested improvements to the CLI and details about an upcoming maintenance window next month, and breaking changes landing the month after that, which may require you to update your apps.
We released version v1.19.0 of the developer tools for our Slack platform beta.
We released version v1.18.0 of the developer tools for our Slack platform beta. View our new curated collection of sample apps for inspiration and illustration.