Most problems are one of four: the agent is connected to another Apiway account, the agent's tools are switched off, the preview is asleep, or the plan does not include the action. The app's page names the problem and gives a task that fixes it.
Steps
- Check the accountAsk your agent: “Are you connected to Apiway? Name the Apiway account and list my apps.” It must name the account that owns the app.
- Check the toolsIn Claude: Settings → Connectors → apiway.ai → Tool permissions → “Always allow” for all three groups, then a new chat.
- Wake the previewIf the page says The preview is asleep, press Wake up.
- Fix an errorWhen something is broken, the app's page offers Fix with your agent: it copies a task for your agent, which finds the cause, fixes it and updates the preview. Fix it with Apiway gives the same task to Apiway's agent.
- Look at the logPress ⋯ → Log.
- Go backPress ⋯ → Versions and bring an older version back into the preview.
What the screen says and what it means
| The screen says | What to do |
|---|---|
| <agent> is not connected to Apiway yet — connect it | Connect it on its page under Connect an agent |
| The preview is asleep | Press Wake up |
| Publish your app — it is on any paid plan | Choose a paid plan; building and the preview stay free |
| Free · N days left | A free app is hosted for 30 days from its first preview. Upgrade and it stays |
| The preview is empty | Give the task to your agent: ⋯ → Task for the agent |
If it did not work
- The agent still does not see the app: Disconnect Apiway in the agent's connector settings, sign in to apiway.ai as the app's owner, connect again and start a new chat.
- A deleted app must come back: An app deleted by hand comes back only through support, within 6 months.
- Nothing above helps: Write to Apiway support and name the app's address.
Questions and answers
Why does a new chat matter?
An open chat does not re-read the list of tools after you change the permissions.
Can my agent delete my app?
No. Deleting is confirmed by the person in Apiway: the window asks to type DELETE.