Troubleshooting errors can be tricky between your development environment, the Slack CLI, and those encountered when running your code. Below are some common ones, as well as a list of the errors the Slack CLI may raise, what they mean, and some ways to remediate them.
Message: You don't have the permission to access the specified resource
Remediation: Check with your Slack admin to make sure that you have permission to access the resource.
Message: Couldn't save your app's info to this project
Message: You're already logged out
Message: The app already has a resolution and cannot be requested
Message: Couldn't create a new app
Message: App already exists belonging to the team
Message: This app is currently denied for installation
Remediation: Reach out to an admin for additional information, or try requesting again with different scopes and outgoing domains
Message: This app requires permissions that must be reviewed by an admin before you can install it
Message: This app has requested admin approval to install and is awaiting review
Remediation: Reach out to an admin for additional information
Message: Specified app and team are mismatched
Remediation: Try a different combination of --app and --team flags
Message: Couldn't create your app
Message: Couldn't delete your app
Message: Couldn't deploy your app
Message: Deployment to Slack is not currently supported for apps with runOnSlack set as false
Remediation: Learn about building apps with the Deno Slack SDK:
https://docs.slack.dev/tools/deno-slack-sdk
If you are using a Bolt framework, add a deploy hook then run: slack deploy
Otherwise start your app for local development with: slack run
Message: The app was neither in the app directory nor created on this team/org, and cannot be requested
Message: Couldn't access app directory
Message: The --app flag must be provided
Remediation: Choose a specific app with --app <app_id>
Message: An app was found
Message: App is configured for Run on Slack infrastructure
Message: Couldn't install your app to a workspace
Message: Couldn't access your app manifest
Message: Couldn't create your app manifest
Message: Couldn't generate an app manifest from this project
Remediation: Check to make sure you are in a valid Slack project directory and that your project has no compilation errors.
Message: The app manifest was not updated
Message: Your app manifest is invalid
Message: The specified app is not eligible for this API
Message: The app was not found
Message: App is not configured to be deployed to the Slack platform
Remediation: Deploy an app containing workflow automations to Slack managed infrastructure Read about ROSI: https://docs.slack.dev/workflows/run-on-slack-infrastructure
Message: The provided app must be installed on this team
Message: Couldn't remove your app
Message: Couldn't rename your app
Message: Couldn't get a list of your apps
Message: Couldn't find a valid auth token for the Slack API
Remediation: You need to be logged in to at least 1 production (slack.com) team to use this command. Log into one with the slack login command and try again.
Message: Couldn't receive authorization in the time allowed
Remediation: Ensure you have pasted the command in a Slack workspace and accepted the permissions.
Message: Couldn't get a token with an active session
Message: Couldn't verify your authorization
Message: Your app must be invited to the channel
Remediation: Try to find the channel declared the source code of a workflow or function.
Open Slack, join the channel, invite your app, and try the command again. Learn more: https://slack.com/help/articles/201980108-Add-people-to-a-channel
Message: The last owner cannot be removed
Message: Unable to add the given user as owner
Message: Unable to retrieve current app collaborators
Message: Unable to delete app
Message: Calling user is unable to list collaborators
Message: Calling user is unable to list owners
Message: User is unable to remove collaborators
Message: Unable to remove the given user
Message: Revoking org-level bot token is not supported
Message: Couldn't find the specified Slack channel
Remediation: Try adding your app as a member to the channel.
Message: Couldn't auto-update this command-line tool
Remediation: You can manually install the latest version from: https://docs.slack.dev/tools/slack-cli
Message: Configuration invalid
Remediation: Check your config.json file.
Message: The .slack/cli.json configuration file is not supported
Remediation: This version of the CLI no longer supports this configuration file. Move the .slack/cli.json file to .slack/hooks.json and try again.
Message: There was an error reading configuration
Remediation: Check your config.json file.
Message: Slack API requires the latest version of the Slack CLI
Remediation: You can upgrade to the latest version of the Slack CLI using the command: slack upgrade
Message: Your admin is requesting a reason to approve installation of this app
Message: The admin does not allow connected organizations to be named_entities
Message: The admin does not allow connected teams to be named_entities
Message: A connector requires admin approval before it can be installed Approval is pending review
Remediation: Contact your Slack admin about the status of your request
Message: A connector requires admin approval before it can be installed
Remediation: Request approval for the given connector from your Slack admin
Message: A connector has been denied for use by an admin
Remediation: Contact your Slack admin
Message: A connector requires installation before it can be used
Remediation: Request installation for the given connector
Message: The context value could not be found
Message: No authentication found for this team
Remediation: Use the command slack login to login to this workspace
customizable_input_missing_matching_workflow_input {#customizable_input_missing_matching_workflow_input}
Message: Customizable input on the trigger must map to a workflow input of the same name
Message: Customizable input has been mapped to a workflow input of an unsupported type. Only UserID, ChannelId, and String are supported for customizable inputs
customizable_inputs_not_allowed_on_optional_inputs {#customizable_inputs_not_allowed_on_optional_inputs}
Message: Customizable trigger inputs must map to required workflow inputs
customizable_inputs_only_allowed_on_link_triggers {#customizable_inputs_only_allowed_on_link_triggers}
Message: Customizable inputs are only allowed on link triggers
Message: An error occurred while accessing your datastore
Message: The primary key for the datastore is missing
Message: The specified datastore could not be found
Message: Couldn't access the default app
Message: Couldn't set this app as the default
Message: Couldn't find the 'deno' language runtime installed on this system
Remediation: To install Deno, visit https://deno.land/#installation.
Message: A deployed app cannot be used by this command
Message: Invalid docs command. Did you mean to search?
Remediation: Use --search flag: slack docs --search "<query>"
Message: Failed to generate documentation
Message: The enterprise was not found
Message: Failed to get teams for restricted user
Message: Failed writing a collaborator record for this new app
Message: Failed to create the app model
Message: Failed while managing datastore infrastructure
Remediation: Please try again and reach out to feedback@slack.com if the problem persists.
Message: Couldn't export the app manifest
Message: At least one request was not cancelled
Message: Couldn't find the user to install the app
Message: Couldn't save the logs
Message: The name of the feedback is invalid
Remediation: View the feedback options with slack feedback --help
Message: The name of the feedback is required
Remediation: Please provide a --name <string> flag or remove the --no-prompt flag
View feedback options with slack feedback --help
Message: Not an acceptable S3 file
Message: The authenticated team cannot use this API
Message: Free workspaces do not support the Slack platform's low-code automation for workflows and functions
Remediation: You can install this app if you upgrade your workspace: https://slack.com/pricing.
Message: The provided function_id does not belong to this app_id
Message: The specified function couldn't be found
Message: Git failed to clone repository
Message: Couldn't find Git installed on this system
Remediation: To install Git, visit https://github.com/git-guides/install-git.
Message: Cannot download Git repository as a .zip archive
Message: Failed to read/create .slack/ directory in your home directory
Remediation: A Slack directory is required for retrieving/storing auth credentials and config data. Check permissions on your system.
Message: Missing the Slack hooks file from project configurations
Remediation: A .slack/hooks.json file must be present in the project's .slack directory.
Message: Hosted apps do not support user scopes
Message: HTTP request failed
Message: Received an invalid response from the server
Message: The method was not called via a POST request
Message: Couldn't install the app because the installation request was denied
Remediation: Reach out to one of your App Managers for additional information.
Message: Couldn't install the app
Message: A valid installation of this app is required to take this action
Remediation: Install the app with slack install
Message: An internal error has occurred with the Slack platform
Remediation: Please reach out to feedback@slack.com if the problem persists.
Message: Either the app does not exist or an app created from the provided manifest would not be valid
Message: This is an invalid Slack app project directory
Remediation: A valid Slack project includes the Slack hooks file: .slack/hooks.json
If this is a Slack project, you can initialize it with slack init
Message: The provided --app flag value is not valid
Remediation: Specify the environment with --app local or --app deployed
Or choose a specific app with --app <app_id>
Message: App ID may be invalid for this user account and workspace
Remediation: Check to make sure you are signed into the correct workspace for this app and you have the required permissions to perform this action.
Message: Required arguments either were not provided or contain invalid values
Message: Slack API request parameters are invalid
Message: A trigger input parameter with customizable: true cannot be set as hidden or locked, nor have a value provided at trigger creation time
Message: Your user account authorization isn't valid
Remediation: Your user account authorization may be expired or does not have permission to access the resource. Try to login to the same user account again using slack login.
Message: The challenge code is invalid
Remediation: The previous slash command and challenge code have now expired. To retry, use slack login, paste the slash command in any Slack channel, and enter the challenge code displayed by Slack. It is easiest to copy & paste the challenge code.
Message: Channel ID specified doesn't exist or you do not have permissions to access it
Remediation: Channel ID appears to be formatted correctly. Check if this channel exists on the current team and that you have permissions to access it.
Message: Value passed for cursor was not valid or is valid no longer
Message: Invalid datastore specified in your project
Message: The provided expression is not valid
Remediation: Verify the expression you provided is valid JSON surrounded by quotations
Use slack datastore --help for examples
Message: This function requires distribution_type to be set as named_entities before adding users
Message: The provided flag value is invalid
Message: One or more input parameter types isn't supported by the link trigger type
Message: The provided manifest file does not validate against schema. Consult the additional errors field to locate specific issues
Message: A manifest does not exist at the provided source
Remediation: Set 'manifest.source' to either "remote" or "local" in .slack/config.json
Read about manifest sourcing with the slack manifest info --help command
Message: slack_cli_version supplied is invalid
Message: Permission type must be set to named_entities before you can manage users
Message: The given refresh token is invalid
Message: The request_id passed is invalid
Message: The resource_id for the given resource_type is invalid
Message: The resource_type argument is invalid.
Message: An internal error occurred
Remediation: Please reach out to feedback@slack.com if the problem persists.
Message: Some of the provided scopes do not exist
Message: The provided version does not follow semantic versioning
Message: Current directory is not a Slack project
Remediation: Change in to a Slack project directory. A Slack project always includes the Slack hooks file (.slack/hooks.json).
Message: The provided token is not valid
Message: Invalid trigger specified in your project
Message: Trigger access can not be configured for more than 10 users
Message: The provided trigger object does not conform to the trigger type's schema
Message: The provided event type is not allowed
Message: Required inputs for the referenced function/workflow are not passed
Message: The provided trigger type is not recognized
Message: A value passed as a user_id is invalid
Message: Only one of schema or schema_ref should be provided
Message: Unable to parse the schema ref
Message: A value passed as workflow_app_id is invalid or missing
Message: A value passed as a workflow ID is invalid
Message: Restricted users cannot request
Message: Couldn't find the local app
Message: A local app cannot be used by this command
Message: Couldn't remove local app
Message: Couldn't run app locally
Message: This API method is not supported
Message: The provided flags cannot be used together
Message: workflow_app_id is required to update via workflow reference
Message: team_id is required to create or update this app
Message: Challenge must be supplied
Message: The feature is behind an experiment not toggled on
Message: An argument must be provided for the flag
Message: Could not find the given workflow using the specified reference
Message: A required value was not supplied as input
Message: There are no options to select from
Message: Your login is out of date
Remediation: Run slack logout and then slack login again.
Message: Additional scopes are required to create this type of trigger
Message: The user was not found
Message: Missing value property on an input. You must either provide the value now, or mark this input as customizable: true and provide the value at the time the trigger is executed.
Message: Couldn't upload your bundled code to server
Remediation: Please try again
Message: Pending request not found
Message: You are either not a collaborator on this app or you do not have permissions to perform this action
Remediation: Contact the app owner to add you as a collaborator
Message: No tokens found to delete
Message: There are no triggers installed for this app
Message: None of the provided named entities were valid
Message: You are either not logged in or your login session has expired
Remediation: Authorize your CLI with slack login
Message: Incompatible token type provided
Message: Couldn't find row
Message: A different org workspace grant already exists for the installed app
Message: One or more of the listed organizations was not connected
Message: One or more of the listed organizations could not be found
Message: This operating system is not supported
Message: Workspace exceeded the maximum number of Run On Slack functions and/or app datastores.
Message: There were problems when validating the inputs against the function parameters. See API response for more details
Message: The process received an interrupt signal
Message: An error occurred while compiling your code
Message: The "project_id" property is missing from the project-level configuration file
Message: Project manifest source is not valid
Remediation: Set 'manifest.source' to either "remote" or "local" in .slack/config.json
Read about manifest sourcing with the slack manifest info --help command
Message: Failed to update project files
Message: An error occurred while executing prompts
Message: The provided provider_key is invalid
Message: This action is only permitted for published app IDs
Message: Too many calls in succession during a short period of time
Message: Must include a request_id or app_id
Message: Your Slack plan does not have access to the requested feature
Message: The hook runtime executable was not found
Remediation: Make sure the required runtime has been installed to run hook scripts.
Message: The SDK runtime is not supported by the CLI
Message: Couldn't create app from sample
Message: Scopes requested exceed app configuration
Message: There was an error while reading the Slack hooks file (.slack/hooks.json) or running the get-hooks hook
Remediation: Run slack doctor to check that your system dependencies are up-to-date.
Message: A script hook defined in the Slack Configuration file (.slack/hooks.json) returned an error
Remediation: Run slack doctor to check that your system dependencies are up-to-date.
Message: A script in .slack/hooks.json was not found
Remediation: Hook scripts are defined in one of these Slack hooks files:
- slack.json
- .slack/hooks.json
Every app requires a Slack hooks file and you can find an example at: https://github.com/slack-samples/deno-starter-template/blob/main/.slack/hooks.json
You can create a hooks file manually or with the slack init command.
When manually creating the hooks file, you must install the hook dependencies.
Message: Your workspace has exhausted the 10 apps limit for free teams. To create more apps, upgrade your Slack plan at https://my.slack.com/plans
Message: The team admin does not allow shared channels to be named_entities
Message: You are not logged into a team or have not installed an app
Remediation: Use the command slack login to login and slack install to install your app
Message: The slack.json configuration file is deprecated
Remediation: Next major version of the CLI will no longer support this configuration file. Move the slack.json file to .slack/hooks.json and continue onwards.
Message: The .slack/slack.json configuration file is deprecated
Remediation: Next major version of the CLI will no longer support this configuration file. Move the .slack/slack.json file to .slack/hooks.json and proceed again.
Message: Couldn't connect to Slack over WebSocket
Message: Failed to stream the most recent activity logs
Message: The specified subdirectory was not found in the template repository
Message: Survey config not found
Message: The "system_id" property is missing from the system-level configuration file
Message: Couldn't verify all system requirements
Message: There was an issue granting access to the team
Message: The --team flag must be provided
Remediation: Choose a specific team with --team <team_domain> or --team <team_id>
Message: Couldn't get a list of teams
Message: One or more of the listed teams was not connected by org
Message: Team could not be found
Message: Cannot query team by domain because team is not on an enterprise
Message: Total number of requests exceeded team quota
Message: No template app was found at the provided path
Message: Your access token has expired
Remediation: Use the command slack login to authenticate again
Message: Your token has already been revoked
Remediation: Use the command slack login to authenticate again
Message: An error occurred while rotating your access token
Remediation: Use the command slack login to authenticate again
Message: Cannot have more than 10 customizable inputs
Message: Ensure you provide only app_id OR request_id
Message: Too many named entities passed into the trigger permissions setting
Message: Couldn't create a trigger
Message: Couldn't delete a trigger
Message: The trigger provided does not exist
Message: The specified trigger cannot be found
Message: Couldn't update a trigger
Message: There was an error deleting tokens
Message: Error with file upload
Message: <json> Couldn't be parsed as a json object
Message: The uninstall process was interrupted
Message: Unknown file type, must be application/zip
Message: The provided function_id was not found
Message: The Slack API method does not exist or you do not have permissions to access it
Message: Unable to find the corresponding type based on the schema ref
Message: The provided workflow_id was not found for this app
Message: File name is not supported
Message: Source is by an unknown or untrusted author
Remediation: Use --force flag or set trust_unknown_sources: true in config.json file to disable warning
Message: The user is already an owner for this app
Message: The user has a request pending for this app
Message: You do not have permissions to install this app
Remediation: Reach out to one of your App Managers to request permissions to install apps.
Message: Must include a user_id to cancel request for an app with app_id
Message: User cannot be found
Message: User removed from team (generated)
Message: Workflow not found
Message: An error occurred while parsing the app manifest YAML file
These error codes might reference an error you've encountered, but not provide enough details for a workaround.
For more help, post to our issue tracker: https://github.com/slackapi/slack-cli/issues