Error Codes and Recovery
Genie uses numeric error codes for blocking errors and rare support-worthy warnings. The code is stable enough to share with support; the internal engineering reason stays hidden.
How to read a code
Section titled “How to read a code”- The first digit points to the product area.
- The message next to the code is the most important recovery instruction.
- Progress messages and normal status updates do not need codes.
- If a warning still exposes Preview, Copy, or Apply, read the warning before using those actions.
Code ranges
Section titled “Code ranges”| Code range | Area | Common next step |
|---|---|---|
| 1000-1099 | CODE planning and safe stops | Refresh context, answer clarification questions, or make the request more specific. |
| 1100-1199 | CODE draft generation and preview readiness | Try again, narrow the prompt, or inspect available Preview/Copy output. |
| 1200-1299 | CODE delta diagnostics | Usually hidden; if shown, refresh the selected script and retry. |
| 2000-2199 | Provider, API key, endpoint, network, or rate limit | Check provider credentials, endpoint, network, quota, or temporary provider status. |
| 3000-3099 | Preview, apply, clipboard, or verification | Check Script Workspace, refresh selection, then retry only after confirming the target. |
| 4000-4099 | Script Workspace capture and Discovery | Open Script Workspace, select the target script, then click Add Selection or Add Scripts again. |
| 4100-4199 | Quick Code selection guards | Select the exact script steps again or send broader work through chat CODE. |
| 5000-5199 | DATA, QUERY, and migration guardrails | Review the SQL or confirmation text, then retry with the requested scope. |
| 6000-6199 | Web UI, files, charts, dictation, and exports | Retry the UI action or check local file/permission state. |
| 7000-7199 | Workbench and Local MCP | Recopy the MCP setup snippet and confirm the bridge is running. |
| 8000-8199 | License, trial, activation, and support access | Open Settings > General, resolve activation, then retry. |
Frequent codes
Section titled “Frequent codes”| Code | Meaning | What to do |
|---|---|---|
| 1001 | The code request could not finish planning. | Refresh the selection and send the request again. |
| 1002 | The request took too long to prepare. | Refresh the selection and try again. |
| 1104 | The generated code was not in a preview-safe format. | Try again with a more specific request. |
| 2001-2004 | Provider credentials or endpoint are missing or invalid. | Open Settings > Models and update the provider key or endpoint. |
| 2005-2006 | Network, rate limit, or temporary provider overload. | Check connectivity and retry after a short wait. |
| 3002 | The selected script changed before apply. | Refresh selection and confirm the intended script is still active. |
| 3005 | The update was sent but could not be verified. | Check Script Workspace before retrying. |
| 4001-4005 | Script Workspace or selected script could not be captured. | Bring Script Workspace forward, select the script, then add context again. |
| 4104 | The edit is too broad for Quick Code. | Send the request in chat CODE instead. |
| 5004 | DATA tried to perform unsupported schema or manual FileMaker work. | Split supported DATA work from manual FileMaker setup. |
| 8001 | Activation key was not recognized. | Check for extra spaces, confirm the key source, and try again. |
Before contacting support
Section titled “Before contacting support”Capture the visible error code, the message beside it, and the approximate time it happened. If the issue involved CODE or apply, also note whether Preview, Copy, or Apply was available.
Use Support Ticket when the recovery step does not clear the issue.