---
title: "Troubleshooting"
description: "Fixes for common Wireflow problems: API, upload and app errors, AI agents that can't see the Wireflow tools, and webhooks your server missed."
updated: 2026-10-26
---

Find your problem below and follow the link to the section that fixes it, starting with errors from the Wireflow API.

## Where are the fixes for API errors, uploads and webhooks?

Start with the API troubleshooting page, which takes each error the API returns and gives its cause, the fix and a way to check it. The other sections cover one surface each:

- [Why is my Wireflow API request failing?](/docs/api/troubleshooting)
- [What can go wrong with an upload?](/docs/api/upload-a-file-and-use-it-in-a-run#what-can-go-wrong-with-an-upload)
- [What happens when I hit a limit?](/docs/limits#what-happens-when-i-hit-a-limit)
- [Error format and status codes](/docs/api/errors): the error shapes and the message behind each HTTP status.
- [Media upload error codes](/docs/api/media#errors): `unsupported_type`, `file_too_large`, `upload_busy` and the rest, with what each one means.
- [Apps API errors](/docs/api/apps#errors): errors from calls to a published app.
- [What happens if my server misses the webhook?](/docs/check-when-a-run-is-finished#what-happens-if-my-server-misses-the-webhook): Wireflow retries the delivery, and polling still works if every attempt fails.

## Where are the fixes when my AI agent can't see the Wireflow tools?

First run the read-only test prompt in [How do I test the connection?](/docs/use-wireflow-from-your-agent#how-do-i-test-the-connection), which spends no credits. If the agent still can't find the tools, open the section for your agent:

- Claude Code: [Why can't Claude Code see the Wireflow tools?](/docs/generate-videos-in-claude-code#why-cant-claude-code-see-the-wireflow-tools)
- Claude app: [How do I add Wireflow to Claude and sign in?](/docs/agents/claude-app#how-do-i-add-wireflow-to-claude-and-sign-in)
- Cursor: [Why won't my MCP server connect in Cursor?](/docs/generate-images-and-videos-in-cursor#why-wont-my-mcp-server-connect-in-cursor)
- ChatGPT: [Why does the ChatGPT connector fail with an OAuth or URL error?](/docs/chatgpt-image-and-video-connector#why-does-the-chatgpt-connector-fail-with-an-oauth-or-url-error)
- GitHub Copilot in VS Code: [Why won't my MCP server start or connect in VS Code?](/docs/agents/github-copilot#why-wont-my-mcp-server-start-or-connect-in-vs-code)
- Gemini CLI: [What does "disconnected" mean, and how do I fix it?](/docs/agents/gemini-cli#what-does-disconnected-mean-and-how-do-i-fix-it)
- Any other agent: [general fixes for MCP connection problems](/docs/agents/fix-mcp-connection-problems).

Last updated: 2026-10-26

---

Documentation index: fetch https://www.wireflow.ai/llms.txt for the full list of Wireflow docs.