> ## Documentation Index
> Fetch the complete documentation index at: https://apidocs.neetoform.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

> Fixes for the errors the neetoform CLI reports.

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.

```bash theme={"system"}
neetoform doctor --subdomain acme
```

## 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](/cli/installation).

## Not authenticated

```
Not authenticated. Run 'neetoform login' to authenticate.
```

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

## Multiple subdomains authenticated

```
Multiple subdomains authenticated (acme, beta); specify --subdomain or --all.
```

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

```
Not authenticated for "acme". Authenticated subdomains: beta, gamma.
```

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

```
Subdomain not found. Please check that you entered the correct subdomain.
For example, if your NeetoForm URL is acme.neetoform.com then enter 'acme'.
```

`login` could not find a workspace at that address. Enter only the subdomain,
not the full URL. See [Workspace subdomain](/getting-started/workspace-subdomain).

## Sign in never completes

```
NeetoForm CLI authentication timed out after 2 minutes. Please try again.
```

`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:

```
API error (403): You are not authorized to perform this action.

Suggestion: You do not have permission to perform this action.
```

| Status | What it usually means                                                                                           |
| ------ | --------------------------------------------------------------------------------------------------------------- |
| 401    | The stored session expired. Run `neetoform login` again.                                                        |
| 403    | Your organization role does not allow this. The CLI acts as you, so an admin-only action fails for a non-admin. |
| 404    | The id does not exist in this workspace. Check it, and check `--subdomain`.                                     |
| 422    | A required field is missing or invalid. Run `neetoform <command> --help`.                                       |
| 429    | Rate limited. Wait and retry.                                                                                   |

## Invalid status filter

```
Invalid --status "draft"; valid values: active, archived, favorite
```

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

## Required flag not set

```
required flag(s) "emails", "role" not set
```

Cobra reports missing required flags before any request is made. See the flag
table for the command in the [command reference](/cli-reference/overview).

## 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](/cli/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.