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

# Troubleshooting

> Diagnose authentication and connectivity issues with neetocal doctor.

## Run the doctor

`neetocal doctor` is the first thing to run when something isn't working. It checks that you are authenticated, that the API is reachable, and reports the CLI version.

```bash theme={"system"}
neetocal doctor
```

When multiple workspaces are logged in, name the one to check:

```bash theme={"system"}
neetocal doctor --subdomain your-workspace
```

## Common errors

Every command exits non-zero on failure and writes a single-line message to `stderr`.

<AccordionGroup>
  <Accordion title="not logged in. Run 'neetocal login' to authenticate">
    **Problem**: no workspace is logged in. <br />
    **Solution**: run [`neetocal login --subdomain <name>`](/cli/authentication).
  </Accordion>

  <Accordion title="multiple subdomains logged in (acme, beta); specify --subdomain">
    **Problem**: more than one workspace is logged in, so the target is ambiguous. <br />
    **Solution**: add `--subdomain <name>` to the command.
  </Accordion>

  <Accordion title="not logged in to &#x22;foo&#x22;. Logged in subdomains: acme, beta">
    **Problem**: the `--subdomain` value doesn't match any logged-in workspace. <br />
    **Solution**: use one of the listed subdomains, or [log in](/cli/authentication) to the new one.
  </Accordion>

  <Accordion title="required flag(s) &#x22;xxx&#x22; not set">
    **Problem**: a required flag was omitted. <br />
    **Solution**: check the command's [reference page](/cli-reference/overview) or run `neetocal <command> --help` for the required flags.
  </Accordion>

  <Accordion title="An API error message">
    **Problem**: the server rejected the request (for example, a validation error). <br />
    **Solution**: the server's message is passed through. Inspect the JSON envelope (or the `--quiet` payload) for `error`, `errors`, or `notice` keys and any suggestions the API returns.
  </Accordion>
</AccordionGroup>

## Check the version

```bash theme={"system"}
neetocal version
```

Prints the CLI version, commit hash, and build date — useful when reporting an issue.