Troubleshooting
"Token missing required ability …"
The token doesn't carry the ability the tool needs. Mint a new one at API tokens with the right abilities.
401 Unauthorized
Token is wrong, expired, or revoked. Mint a fresh one and update your client config.
404 on a form_id you own
Tokens are team-scoped. The form belongs to a different team. Switch your active team in the dashboard, mint a token in that team, and try again.
423 / "AI Insights are not available on your current plan"
The team's plan doesn't include AI features. Upgrade in Billing or skip the AI tools.
"Insights regeneration is already running"
regenerate_ai_insights is locked for 5 minutes after a trigger. Wait, then retry.
Agent doesn't see the tools after editing config
Quit the client fully (don't just close the window) and relaunch. MCP server lists are cached at startup. Zed is the exception — it hot-reloads.
Webhook secret returned null
Some clients hide non-data fields. Recreate the webhook to get a fresh secret, or call the REST API directly.