Run the doctor
When something goes wrong, start withneetoform doctor. It checks your authentication, API connection, and CLI version.
Common errors
When a command fails, it prints an error message to standard error and exits with status 1. Usage errors such as an unknown flag or a missing argument addRun 'neetoform --help' for usage.
Not authenticated. Run 'neetoform login' to authenticate.
Not authenticated. Run 'neetoform login' to authenticate.
Problem: no workspace is signed in.
Solution: run
Solution: run
neetoform login --subdomain <name>.Multiple subdomains authenticated (acme, beta); specify --subdomain.
Multiple subdomains authenticated (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. For logout, --all signs out of every workspace.Not authenticated for "foo". Authenticated subdomains: acme, beta.
Not authenticated for "foo". Authenticated subdomains: acme, beta.
Problem: the
Solution: use one of the listed subdomains, or sign in to the new one.
--subdomain value does not match any signed-in workspace. Solution: use one of the listed subdomains, or sign in to the new one.
Subdomain not found. Please check that you entered the correct subdomain.
Subdomain not found. Please check that you entered the correct subdomain.
Problem:
Solution: use the first part of your workspace URL. For
neetoform login could not find a workspace at <subdomain>.neetoform.com. Solution: use the first part of your workspace URL. For
https://spinkart.neetoform.com, enter spinkart.Authentication session expired. Please try again.
Authentication session expired. Please try again.
Problem: the browser sign-in was not approved before the session expired.
Solution: run
NeetoForm CLI authentication timed out after 5 minutes. Please try again. means the CLI stopped waiting. Solution: run
neetoform login again and approve the sign-in in the browser. If the browser does not open, visit the URL the CLI prints.Could not connect to NeetoForm. Check your internet connection
Could not connect to NeetoForm. Check your internet connection
Problem: the CLI could not reach the API.
Solution: check your network and run
Solution: check your network and run
neetoform doctor. If NEETOFORM_BASE_URL is set, confirm it points at a reachable server.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
neetoform <command> --help for the required flags.Invalid --status "draft". Valid values: active, archived, favorite.
Invalid --status "draft". Valid values: active, archived, favorite.
Problem:
Solution: use
neetoform forms list --status got a value it does not accept. Solution: use
active, archived, or favorite.API error (422): <message>
API error (422): <message>
Problem: the server rejected the request. The CLI prints
Solution: follow the suggestion. For 401, run
API error (<status>): <message>, one line per additional error, and a Suggestion: line for common statuses: 401 (sign in again), 403 (no permission), 404 (check the ID), 422 (check required fields with --help), and 429 (rate limited, wait and retry). Solution: follow the suggestion. For 401, run
neetoform login to refresh the session.Claude Code not found (~/.claude/ does not exist).
Claude Code not found (~/.claude/ does not exist).
Problem:
Solution: install and open Claude Code, then run the command again.
neetoform setup claude requires Claude Code to have been run at least once. Solution: install and open Claude Code, then run the command again.
Organization roles
team-members create and team-members update match the --role value exactly, including case, against the roles in your workspace. If a role is rejected, check the Roles page in your workspace settings for the exact spelling.
Check the version
neetoform update.