Most problems come from the AI agent's own settings, old instructions in your Project, or a missing Agent Guide. Start a new chat after any change, then check the troubleshooting section on your AI agent's setup page.
Most connection problems are fixed in your AI agent, not in FlipperForce. Each AI agent is a little different, so start with the troubleshooting section on its setup page:
Check these first
- Start a new chat. Settings and instruction changes don't reach a conversation that's already open. This is the most common false alarm.
- Every call fails right away (Claude). The domain allowlist isn't set up. Add tools.flipperforce.com under Settings, then Capabilities.
- It changed data without asking. Older instructions are still in your Project. Replace them with ours.
- It invents endpoints that don't exist. The Agent Guide is missing or was uploaded inside a zip. Upload the .txt file directly.
Error codes
- 401 Unauthorized: the key is invalid or your subscription has lapsed.
- 403 on one feature: usually your plan or workspace role doesn't include that module. Ask your AI agent to show the message the API returned instead of retrying.
- 422 Unprocessable: a required field is missing or in the wrong format. Ask to see the exact request it sent.
- 429 Too Many Requests: calls are going out too fast. Ask it to slow down and retry.
The numbers don't match FlipperForce
Your AI agent probably added up one page of results. Tell it to use the totals the API returns and to follow pagination to the end.
Still stuck?
Email support@flipperforce.com, or start a chat from inside FlipperForce. Tell us which AI agent you use, which step you're on and what it showed you.
