Run the doctor
When something goes wrong, start withneetocal doctor. It checks your authentication, API connection, and CLI version.
Common errors
When a command fails, it prints a one-line error message.not logged in. Run 'neetocal login' to authenticate
not logged in. Run 'neetocal login' to authenticate
Problem: no workspace is logged in.
Solution: run
Solution: run
neetocal login --subdomain <name>.multiple subdomains logged in (acme, beta); specify --subdomain
multiple subdomains logged in (acme, beta); specify --subdomain
Problem: more than one workspace is signed in, so the target is ambiguous.
Solution: add
Solution: add
--subdomain <name> to the command.not logged in to "foo". Logged in subdomains: acme, beta
not logged in to "foo". Logged in subdomains: acme, beta
Problem: the
Solution: use one of the listed subdomains, or log in to the new one.
--subdomain value doesn’t match any logged-in workspace. Solution: use one of the listed subdomains, or log in to the new one.
required flag(s) "xxx" not set
required flag(s) "xxx" not set
Problem: a required flag was omitted.
Solution: check the command’s reference page or run
Solution: check the command’s reference page or run
neetocal <command> --help for the required flags.An API error message
An API error message
Problem: the server rejected the request (for example, a validation error).
Solution: the CLI passes through the server’s message. Check the JSON envelope (or
Solution: the CLI passes through the server’s message. Check the JSON envelope (or
--quiet payload) for error, errors, or notice and any suggestions from the API.