algolia-common-errors

Featured

Diagnose and fix the top Algolia API errors: 400, 403, 404, 429, ApiError, RetryError, and indexing failures. Trigger: "algolia error", "fix algolia", "algolia not working", "debug algolia", "algolia 429", "algolia 403".

AI & Automation 2,926 stars 433 forks Updated yesterday MIT

Install

View on GitHub

Quality Score: 99/100

Stars 20%
100
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# 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...

Details

Author
jeremylongshore
Repository
jeremylongshore/claude-code-plugins-plus-skills
Created
1 years ago
Last Updated
yesterday
Language
Python
License
MIT

Integrates with

Bundled in these plugins

Similar Skills

Semantically similar based on skill content — not just same category