Apiway

App Factory

What do I do when App Factory or my agent does not work

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.

Last updated

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

  1. 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.
  2. Check the toolsIn Claude: Settings → Connectors → apiway.ai → Tool permissions → “Always allow” for all three groups, then a new chat.
  3. Wake the previewIf the page says The preview is asleep, press Wake up.
  4. 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.
  5. Look at the logPress ⋯ → Log.
  6. Go backPress ⋯ → Versions and bring an older version back into the preview.

What the screen says and what it means

The screen saysWhat to do
<agent> is not connected to Apiway yet — connect itConnect it on its page under Connect an agent
The preview is asleepPress Wake up
Publish your app — it is on any paid planChoose a paid plan; building and the preview stay free
Free · N days leftA free app is hosted for 30 days from its first preview. Upgrade and it stays
The preview is emptyGive 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.

Related docs