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

# Troubleshooting

> Fix Pointed CLI setup issues and troubleshoot enabled ChatGPT or Codex connections.

## ChatGPT and Codex connections

These steps apply when a Pointed workspace integration has been enabled for you. The public [documentation MCP server](/docs/ai-tools) only searches these guides; it does not connect to your workspace.

* Connect through ChatGPT or Codex's OAuth connection flow. A hosted Pointed connection does not require installing the CLI or pasting an API key, token, password, or client secret into chat.
* Check the workspace reported by the connection. If access is denied or the workspace is wrong, open [Pointed](https://app.usepointed.ai/sign-in), confirm your account and selected workspace, then reconnect through the host.
* Interview evidence requires separate permission and may be disabled for a connection. Use the returned Pointed links to review results when access is unavailable.
* Saving a campaign draft does not send invitations, place calls, or start interviews. Review contacts, consent, and interview settings in Pointed before launching.
* If saving an account or draft times out, check Pointed before retrying. Ask the plugin to retry the same operation with the same request key; a new key can create a duplicate. The plugin manages that key for you.

For help, [contact Pointed](https://usepointed.ai/contact?reason=general) with the host you used, the workflow, and the safe error message. Do not include credentials, customer details, transcripts, or private workspace links.

## Check auth

Confirm you can sign in to [Pointed](https://app.usepointed.ai/sign-in) with the same account. If you only have waitlist access, [contact Pointed](https://usepointed.ai/contact?reason=general) before trying workspace commands.

```bash theme={null}
pointed auth whoami
```

If you are not authenticated:

```bash theme={null}
pointed auth login
```

For automation, use an existing authorized API key as described in [Authentication](/docs/authentication#api-key). To check whether your shell is using a key without printing it:

```bash theme={null}
test -n "$POINTED_API_KEY" && echo "POINTED_API_KEY is set"
```

An API key overrides browser credentials. To return to browser login:

```bash theme={null}
unset POINTED_API_KEY
pointed auth login
pointed auth whoami
```

## Browser login does not finish

Keep the CLI running while you sign in. If the browser did not open, visit the URL printed in the terminal on the same computer. The callback uses `127.0.0.1:3100`; another process on port 3100 or a browser running on a different machine can prevent it from reaching the CLI.

If the login attempt times out, start `pointed auth login` again. If a stored token expires, try `pointed auth refresh`, then `pointed auth whoami`. Do not share the authorization URL or token values in a support request.

## Local file permission errors

Use macOS or Linux. Native Windows ACL validation is not implemented.

Inspect the affected path first. The CLI expects `~/.pointed` to be owned by your user with mode `0700`; its JSON files must be regular files owned by your user with mode `0600`. It rejects symlinks, hard links, and paths owned by another user. Avoid running the CLI with `sudo`.

Correct permissions only after confirming that the path is your own directory or regular file. Preserve existing configuration and exports; do not delete the directory as a generic fix. If ownership is wrong or a link is involved, ask your administrator or [Pointed support](https://usepointed.ai/contact?reason=general) for help. Export directories must also be owned by you and not writable by other users.

## A batch or export reports failure

Read the complete output before retrying. Contact batches and link generation can succeed for some items and still exit with status 1 when others fail. Response exports preserve successful files and write [manifests](/docs/response-exports) with final outcomes. Retry only what still needs attention.

## Check environment

```bash theme={null}
pointed config get apiBaseUrl
pointed config set apiBaseUrl https://app.usepointed.ai
```

If `POINTED_API_URL` is set, it overrides the saved config.

## Use request IDs

CLI API responses include `meta.requestId`. Include that request ID when reporting a failed command.

For help, use [Pointed support](https://usepointed.ai/contact?reason=general) or [CLI issues](https://github.com/PointedAI/usepointed-cli/issues). Include the CLI version, operating system, command name, error, and request ID when available. Remove tokens, customer details, transcripts, and private links before posting a public issue.

## Inspect commands

```bash theme={null}
pointed --help
pointed auth --help
pointed accounts --help
pointed contacts --help
pointed campaigns --help
pointed story-templates --help
pointed invites --help
pointed responses --help
pointed smart-intake --help
```


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