Error Codes and Recovery
Genie uses numeric error codes for blocking errors and rare warnings worth reporting. You can share the code with support.
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 have codes.
- If a warning still shows Preview, Copy, Create, or Apply, read the warning before using those actions.
Code ranges
Section titled “Code ranges”| Code range | Area | Common next step |
|---|---|---|
| 1000-1099 | Script requests that stop before a result | Answer Genie’s questions, or make the request more specific. |
| 1100-1199 | Script drafts and previews | Try again, narrow the prompt, or inspect the available Preview or Copy output. |
| 1200-1299 | Script edit diagnostics | Usually hidden; if shown, click Refresh Selection and retry. |
| 2000-2199 | Provider, API key, endpoint, network, or rate limit | Check provider credentials, endpoint, network, quota, or temporary provider status. |
| 3000-3099 | Writing a script in FileMaker and checking the result | Check the script in FileMaker. Save any unsaved edits, then ask Genie to prepare the change again. |
| 4000-4099 | Script Workspace selection and script lookup | Confirm the exact script name and file. Use Metadata Explorer for known references, or click Refresh Selection. |
| 4100-4199 | QuickCode selection checks | Select the exact script steps again, or send broader work through the chat. |
| 5000-5199 | Data changes and queries | Review the SQL shown in the confirmation, then retry with the scope you want. |
| 6000-6199 | Interface, files, charts, dictation, and exports | Retry the action or check local file and permission settings. |
| 7000-7199 | Workbench and Local MCP | Copy the MCP setup snippet again and confirm the bridge is running. |
| 8000-8199 | Paid plan, activation, and support access | Open Settings > General, check your plan and activation key, then retry. The Free plan stays available. |
Frequent codes
Section titled “Frequent codes”| Code | Meaning | What to do |
|---|---|---|
| 1001 | The script request could not finish. | Send the request again, naming the script exactly. |
| 1002 | The request took too long to prepare. | Try again, or split the request into smaller steps. |
| 1104 | The generated script could not be shown as a preview. | 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 script changed after Genie prepared the review. | Ask Genie to prepare the change again. |
| 3005 | The update was sent but could not be checked. | Check the script in FileMaker before retrying. |
| 304 (FileMaker) | The layout is open with unsaved changes in Layout mode. Nothing was changed. | Save the layout in Layout mode, then ask Genie again. |
| 4001-4005 | The selected script could not be read. | Open the file, select the script lines, and click Refresh Selection, or name the script in your request. |
| 4104 | The edit is too broad for QuickCode. | Send the request in the chat instead. |
| 8001 | Activation key was not recognized. | Check for extra spaces, confirm the key source, and try again. |
Claude Code and Codex messages in Genie have no numeric code. Their messages and remedies are listed in Claude Code and Codex.
Before contacting support
Section titled “Before contacting support”Note the visible error code, the message beside it, and the approximate time it happened. If the issue involved a script, also note whether Preview, Copy, Create, or Apply was available.
Use Support Ticket when the recovery step does not clear the issue.