Skip to main content
Start with neetoform doctor. It checks your credential, reaches the API and prints the installed version, and each check runs independently so one failure does not hide the next.

Command not found

neetoform is not on your PATH. Restart the terminal first, since the installers add the directory to your shell profile and existing sessions do not pick it up. If it still fails, see Installation.

Not authenticated

No workspace is signed in. Run neetoform login --subdomain acme.

Multiple subdomains authenticated

More than one workspace is signed in, so the CLI will not guess. Pass --subdomain <name> on the command. The error lists every signed-in subdomain.

Not authenticated for a subdomain

The name passed to --subdomain is not one you are signed in to. Check the spelling against the list in the error, or sign in to it.

Subdomain not found

login could not find a workspace at that address. Enter only the subdomain, not the full URL. See Workspace subdomain.

Sign in never completes

login waits two minutes for the browser step. If the browser did not open, login also prints the URL to open by hand. Run it again once you can reach that page.

API errors

Failures from the server are printed with the status code, the server’s message and a suggestion:

Invalid status filter

neetoform forms list --status takes only active, archived or favorite.

Required flag not set

Cobra reports missing required flags before any request is made. See the flag table for the command in the command reference.

Unknown organization role

team-members create and team-members update match the role name exactly, including case, against the roles in your workspace. Check the Roles page in workspace settings for the exact spelling.

Table columns are not what you expected

Pretty tables show at most seven columns and trim to your terminal width, so a field you want may not appear. Use --json for the full record. See Output formats.

Still stuck

Run the command again with --json and include the output, plus neetoform version and neetoform doctor, when you report the problem.