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