Error Handling
HTTP errors
| Status | Error | Cause | Solution |
|---|---|---|---|
401 | Unauthorized | Missing or malformed API key | Check Authorization: Bearer kstk_... header |
403 | Forbidden | Invalid or deactivated key | Contact support for a new key |
429 | Too Many Requests | Rate limit or quota exceeded | Wait 60s or upgrade plan |
Tool errors
| Error message | Cause | Solution |
|---|---|---|
"No tests found for query: '...'" | No matches | Broaden search terms or remove filters |
"Invalid section '...'" | Unrecognized section name | Use a valid section value |
"Invalid result_filter '...'" | Bad result filter | Use winner, loser, or inconclusive |
"Search error: ..." | Temporary service issue | Retry in a few seconds |
"Semantic search error: ..." | Embedding service down | Use search_ab_tests as fallback |
"Invalid test ID format" | Not a valid UUID | Check the ID format |
"Test not found: ..." | UUID doesn't exist | Verify the test ID |
Tips
- If keyword search returns no results, try semantic search
- If semantic search is down, keyword search always works
- Combine fewer filters for broader results, then narrow down