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

# Authentication

> Sign in through the browser and manage credentials for one or more workspaces.

The CLI uses your browser to sign you in and securely saves your session, so you never need to enter an API key.

## Sign in

```bash theme={"system"}
neetoengage login --subdomain your-workspace
```

Your browser opens to complete sign-in. The CLI also prints the sign-in URL in case the browser does not open, and waits up to five minutes for you to approve. Once you approve it, the CLI saves credentials for that subdomain. If you omit `--subdomain`, the CLI prompts for it.

<Tip>
  Your subdomain is the first part of your workspace URL - for
  `https://spinkart.neetoengage.com`, the subdomain is `spinkart`. See
  [Workspace subdomain](/cli/workspace-subdomain).
</Tip>

## Where credentials are stored

Credentials for every signed-in workspace live in a single file:

```text theme={"system"}
~/.config/neetoengage/auth.json
```

Removing this file signs you out of every workspace, the same as `neetoengage logout --all`.

## Check who you are

```bash theme={"system"}
neetoengage whoami
```

Lists every signed-in account. When exactly one is signed in, it is marked `(default)`. Pass `--subdomain <name>` to show just one.

## Sign out

```bash theme={"system"}
neetoengage logout --subdomain your-workspace    # remove one workspace
neetoengage logout --all                         # remove every workspace
neetoengage logout                               # remove the only one, if a single workspace is signed in
```

## Working with multiple workspaces

You can sign in to several subdomains at once. To add another workspace, name its subdomain:

```bash theme={"system"}
neetoengage login --subdomain globex
```

When more than one workspace is signed in, every command that talks to the API requires `--subdomain`. If you omit it, the CLI errors and lists the signed-in workspaces.

```bash theme={"system"}
neetoengage tracks list --subdomain acme
neetoengage tracks list --subdomain globex
```

With one signed-in workspace, it is the default and `--subdomain` stays optional.

## Environment variables

`NEETOENGAGE_BASE_URL` overrides the server the CLI talks to. By default every command, including `login`, uses `https://<subdomain>.neetoengage.com`. Set the variable to point the CLI at a staging or local server. Every request, including the session token saved in `~/.config/neetoengage/auth.json`, goes to that server, so only point it at a server you trust:

```bash theme={"system"}
export NEETOENGAGE_BASE_URL=https://acme.neetoengage.net
neetoengage login --subdomain acme
```

## Troubleshooting

If sign-in or connection problems come up, run `neetoengage doctor` first. See [Troubleshooting](/cli/troubleshooting) for common issues and fixes.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.