references/ai-search/gotchas.md
AI Search Troubleshooting Routes
| Symptom or question | Documentation | |---------------------|---------------| | API request fails, including authentication or missing instances | API error codes | | Upload or sync succeeds but content fails during processing | Indexing error codes | | Content is missing or stale | Syncing and supported data sources and formats | | Filters return unexpected documents or no matches | Filtering and metadata attributes | | Thresholds exclude results or responses need tuning | Result controls | | Binding types, response parsing, or streaming fail after an upgrade | Workers binding migration | | Capacity, file-size, or billing questions | Limits and pricing |
For legacy binding behavior, start with API routes. Do not apply current filter syntax or response shapes to legacy calls without following the migration guide.