algolia-common-errors

# Algolia Common Errors ## Overview Quick reference for the most common Algolia errors, their root causes, and fixes. All examples use `algoliasearch` v5 client error types. ## Error Reference ### 1. Invalid Application-ID or API key (403) ``` ApiError: Invalid Application-ID or API key ``` **Cause:** App ID or API key is wrong, expired, or deleted. **Fix:** ```bash # Verify your env vars are set echo "APP_ID: $ALGOLIA_APP_ID" echo "KEY set: ${ALGOLIA_ADMIN_KEY:+yes}" # Test with curl curl -s "https://${ALGOLIA_APP_ID}-dsn.algolia.net/1/indexes" \ -H "X-Algolia-Application-Id: ${ALGOLIA_APP_ID}" \ -H "X-Algolia-API-Key: ${ALGOLIA_ADMIN_KEY}" | head -c 200 ``` Get fresh keys: dashboard.algolia.com > Settings > API Keys. --- ### 2. Method not allowed with this API key (403) ``` ApiError: Method not allowed with this API key ``` **Cause:** Using a Search-Only key for a write operation (saveObjects, setSettings, etc.). **Fix:** Use the Admin API key for write operations. Search-Only keys only permit `search` ACL. ```typescript // Wrong: search-only key for indexing const client = algoliasearch(appId, searchOnlyKey); await client.saveObjects({ ... }); // 403 // Right: admin key for indexing const client = algoliasearch(appId, adminKey); await client.saveObjects({ ... }); // Works ``` --- ### 3. Index does not exist (404) ``` ApiError: Index products_staging does not exist ``` **Cause:** Searching an index that hasn't been created yet. Algolia creates indice...