Troubleshooting & FAQ
Fixes for common issues and answers to frequently asked questions.
Common issues
A run gives an empty result
Make the instructions in DO more specific about the task. Check that the neuron's GET inputs have the values you expect before you run it, and that the output type in MAKE matches what you ask the AI to make.
A file upload is rejected
Check that the input takes that kind of file (see Data types), that the file is no larger than 32 MB, and that it isn't damaged or password-protected. Large files take longer to read.
Telegram messages don't arrive
In the neuron's SEND tab, open the Telegram link, send /start to the Neuron bot, and paste the chat ID it replies with into Telegram chat. See Neuron parts.
Results don't reach my address (SEND › API)
The Endpoint URL in SEND › API must start with https://, http:// or / and be reachable from the internet; an address on your own computer won't work. Clearing the field turns API off. See Webhook integration.
Credits were used but there's no result
AI work uses credits even when a run fails or returns nothing. Find the run on the Usage page, make the instructions clearer, and try again. See Credits & usage.
I can't publish an agent
A workflow can be published only when all its neurons form one connected flow, with no loop and no neuron left on its own. Hover over the greyed-out Publish button to see what needs fixing. See Publishing your agent.
A neuron shows "1 to fix"
The neuron has a problem that stops it running, such as missing instructions or a broken reference. Open the neuron: the tab with the problem is marked, and the issue is shown at the top of it, sometimes with a Fix button. See Neurons.
Play is greyed out
Only one run can go at a time in a workflow. Wait for the current run to finish, or stop it. See Running.
Calls to my neuron's webhook are refused
Check that the API key is active (not revoked or past its expiry date), that it was made for this neuron, and that each call is signed with the key's secret. Webhook integration shows how to send a signed call.
Calls are refused for too many requests
The API key has a rate limit and the calls went over it. Wait, send calls less often, or raise the key's limit on the API Keys page.
A webhook call's status shows failed or timed out
failed means the neuron's run ended with an error: open the neuron and check its result. timed out means the run didn't finish within 1 minute; the run itself may still finish. Try a smaller input or simpler instructions.
Memory is full
The run finished, but what it should remember wasn't saved. Open Memory and free up space. See Memory.