# Troubleshoot the Workato Platform CLI

Use this guide to troubleshoot errors that occur while installing and using the Workato Platform CLI.

# Troubleshoot installation

The following errors may occur when you install the Platform CLI.

# Python version error

You may receive the Python 3.11+ required error when installing the Workato Platform CLI.

Update Python to version 3.11 or later to resolve this Python version error:

1

Run python --version to check your current Python version.

2

Install Python 3.11 or later from python.org (opens new window) or by using your package manager.

# Command not found

You may receive an error that workato: command not found. Complete the following steps to resolve this error:

1

Review your installation to ensure that you installed the Platform CLI correctly. Run pip show workato-platform-cli.

2

Run the help command if the error doesn't resolve: python -m workato_platform.cli.main --help

# Troubleshoot authentication

The following errors may occur when you authenticate the Platform CLI.

# API credentials error

You may receive a Could not resolve API credentials error. Complete the following steps to resolve this error:

1

Run the initialization command: workato init.

2

Follow prompts to enter your API token and continue authentication.


Last updated: 11/3/2025, 7:56:11 PM