perplexity-common-errors

# Perplexity Common Errors ## Overview Quick reference for the top 10 most common Perplexity errors and their solutions. ## Prerequisites - Perplexity SDK installed - API credentials configured - Access to error logs ## Instructions ### Step 1: Identify the Error Check error message and code in your logs or console. ### Step 2: Find Matching Error Below Match your error to one of the documented cases. ### Step 3: Apply Solution Follow the solution steps for your specific error. ## Output - Identified error cause - Applied fix - Verified resolution ## Error Handling ### Authentication Failed **Error Message:** ``` Authentication error: Invalid API key ``` **Cause:** API key is missing, expired, or invalid. **Solution:** ```bash # Verify API key is set echo $PERPLEXITY_API_KEY ``` --- ### Rate Limit Exceeded **Error Message:** ``` Rate limit exceeded. Please retry after X seconds. ``` **Cause:** Too many requests in a short period. **Solution:** Implement exponential backoff. See `perplexity-rate-limits` skill. --- ### Network Timeout **Error Message:** ``` Request timeout after 30000ms ``` **Cause:** Network connectivity or server latency issues. **Solution:** ```typescript // Increase timeout const client = new Client({ timeout: 60000 }); ``` ## Examples ### Quick Diagnostic Commands ```bash # Check Perplexity status curl -s https://status.perplexity.com # Verify API connectivity curl -I https://api.perplexity.com # Check local configuration env | grep PERPLEXITY ``` ### Escalation Path 1. Collect evidence with `perplexity-debug-bundle` 2. Check Perplexity status page 3. Contact support with request ID ## Resources - [Perplexity Status Page](https://status.perplexity.com) - [Perplexity Support](https://docs.perplexity.com/support) - [Perplexity Error Codes](https://docs.perplexity.com/errors) ## Next Steps For comprehensive debugging, see `perplexity-debug-bundle`.