Start with doctor
neetodesk doctor checks each thing independently and reports all of them, so one failure does
not hide the next:
Reading an API error
When the API rejects a request, the CLI reports the status code, the message the API returned and a suggestion:Common problems
Not authenticated. Run 'neetodesk login' to authenticate.
Not authenticated. Run 'neetodesk login' to authenticate.
Problem: No workspace is signed in on this machine.
Solution: Run
Solution: Run
neetodesk login. See Authentication.Multiple subdomains authenticated (acme, globex); specify --subdomain.
Multiple subdomains authenticated (acme, globex); specify --subdomain.
Problem: You are signed in to more than one workspace, so the CLI will not guess which
one you meant.
Solution: Add
Solution: Add
--subdomain acme to the command, or drop the workspaces you no longer
need with neetodesk logout --subdomain globex.Not authenticated for "acme".
Not authenticated for "acme".
Problem: The subdomain you passed is not among the ones signed in. The message lists the
ones that are.
Solution: Check the spelling of the subdomain, then run
Solution: Check the spelling of the subdomain, then run
neetodesk login --subdomain acme.API error (401) after it worked yesterday
API error (401) after it worked yesterday
Problem: The saved session token expired.
Solution: Run
Solution: Run
neetodesk login to sign in again. The stored credential is replaced.Could not connect to NeetoDesk. Check your internet connection.
Could not connect to NeetoDesk. Check your internet connection.
Problem: The CLI could not reach the host at all, rather than being turned away by it.
A proxy or VPN is the usual cause.
Solution: Run
Solution: Run
neetodesk doctor to see which host it is trying, and confirm you can
reach that host in a browser.command not found: neetodesk
command not found: neetodesk
Problem: The install directory is not on your
Solution: Open a new terminal. The installer edits your shell profile, which the running session has already read. See Installation.
PATH. Solution: Open a new terminal. The installer edits your shell profile, which the running session has already read. See Installation.
Completions are missing new commands after an upgrade
Completions are missing new commands after an upgrade
Problem: The completion script on disk is the one the older version wrote.
Solution: Re-run
Solution: Re-run
neetodesk completion <shell>. See
Shell completion.A ticket you can see in the web app is missing from `tickets list`
A ticket you can see in the web app is missing from `tickets list`
Problem: The CLI acts as the person who signed in, so it is bounded by that person’s
role. An agent restricted to their own tickets or to their groups sees a narrowed list.
Solution: Confirm which account you are signed in as with
Solution: Confirm which account you are signed in as with
neetodesk whoami. If the
account is right, the restriction is the role, not the CLI.