Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.meibel.ai/llms.txt

Use this file to discover all available pages before exploring further.

Troubleshooting

Find solutions to common issues when working with Meibel.

Authentication Issues

Invalid API Key Error

Problem: Getting “401 Unauthorized” or “Invalid API key” errors. Solutions:
  1. Verify your API key is set:
    echo $MEIBEL_API_KEY
    
  2. Check the key hasn’t expired in the Dashboard
  3. Ensure you’re using the correct header format:
    curl -H "Meibel-API-Key: your-key" https://api.meibel.ai/v2/datasources
    

Permission Denied

Problem: “403 Forbidden” errors when accessing resources. Solutions:
  • Verify your API key has the necessary permissions
  • Check if you’re accessing resources in the correct project
  • Ensure you’re not exceeding plan limits

Connection Issues

Timeout Errors

Problem: Requests timing out before completion. Solutions:
# Increase timeout
client = MeibelClient(
    api_key=os.getenv("MEIBEL_API_KEY"),
    timeout=60.0,  # 60 seconds
)

SSL Certificate Errors

Problem: SSL verification failures. Solutions:
  1. Update your certificates:
    pip install --upgrade certifi
    

Rate Limiting

429 Too Many Requests

Problem: Hitting rate limits. Solutions:
  1. Implement exponential backoff (see Rate Limits)
  2. Batch operations when possible
  3. Consider upgrading your plan for higher limits

SDK-Specific Issues

Python: Import Errors

pip install meibel
python -c "from meibel import MeibelClient; print('OK')"

TypeScript: Build Errors

npm install meibel
npx tsc --noEmit  # Check for type errors

CLI: Command Not Found

# Reinstall
brew reinstall meibel-ai/tap/meibel

# Or check PATH
which meibel

Getting Help

If you’re still experiencing issues:
  1. Documentation: Review the API Reference
  2. Support: Contact support@meibel.ai with:
    • Error messages and stack traces
    • Steps to reproduce the issue
    • SDK version and language version