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

# Troubleshooting

Diagnose setup, email, widget, forms, knowledge, API, webhooks, and deployment issues.

# Troubleshooting

Use this page as the first diagnostic path before digging into logs.

## Health Check

```bash
curl -I https://api.rogeriq.com/api/health
```

Expected:

```txt
HTTP/2 200
```

## API Returns 401

Check:

- API key starts with `riq_`
- key is sent with `Authorization: Bearer` or `X-API-Key`
- key is not expired
- project belongs to the key organization

## API Returns 403

Check:

- key has the required scope
- browser form origin is allowed
- dashboard user has access to the organization or project

## Widget Does Not Load

Check:

- script URL loads
- `projectId` is correct
- widget is enabled
- display mode is not manual unless you open it yourself
- browser console has no CSP or network errors

## Form Submission Fails

Check:

- form is not archived
- origin is allowed
- required fields are present
- file uploads pass validation
- hosted Turnstile token is present when using hosted form page
- rate limit has not been exceeded

## Knowledge Search Is Weak

Check:

- articles are published
- content was indexed
- crawls completed
- source pages contain meaningful text
- HolyDocs sync has not reported vector errors
- agent guardrails are not blocking otherwise valid answers

## Webhook Not Receiving Events

Check:

- webhook status is active
- event list includes the emitted event or `*`
- target URL accepts `POST`
- target TLS certificate is valid
- signature verification code uses the raw request body
- recent deliveries show status codes