Guides and resources
Troubleshooting
Find your symptom below. For every status code, see Errors and rate limits.
API
| Symptom | What to do |
|---|---|
401 "Missing X-API-KEY header." | Send the key in the X-API-KEY header on every request. |
401 "Invalid or revoked API key." | The key is wrong, or was regenerated or revoked. Copy the current key from the API Key page and update your integration. |
402 with insufficient_balance | Nothing can pay for the chat reply. Add funds or turn on Auto Top-Up in the dashboard. The message can be shown to your customer as it is. |
402 on an upload | The knowledge base needs more storage than your plan and wallet cover. See Usage limits and billing. |
404 with a session_id | The session ID belongs to another company, or the resource doesn't exist. Leave session_id out to start a new conversation. |
409 | Your account setup isn't finished. Complete it in the dashboard. |
413 | The uploaded file is larger than 100 MB. |
422 | Invalid input. detail lists the fields that failed. |
429 | Rate limit exceeded, or too many invalid keys. Wait for the number of seconds in Retry-After. |
502 | The AI could not produce a reply this time. Safe to retry. |
| Chat requests time out | Chat replies usually take 2–8 seconds, longer when a meeting is booked. Use a client timeout of at least 60 seconds. |
| The API works from your server but not from a browser | Call the API from your server only; never put the key in browser code. See Security. |
WordPress plugin
| Symptom | What to do |
|---|---|
| The widget does not appear | Make sure the plugin is version 1.0.8 or newer, then clear any cache or CDN. |
| "Invalid ID!" when saving | Paste only the Company ID, with no spaces or other characters. |
More in the WordPress guide.
n8n
| Symptom | What to do |
|---|---|
| The NUWAY node does not appear | Restart n8n. For Docker, check that N8N_CUSTOM_EXTENSIONS points to the folder that holds the node's package.json, and that npm install created its dist folder. |
| The credential test fails with 401 | The API key is wrong or was regenerated; copy the current key. |
More in the n8n guide.