​

Troubleshooting

​

Authentication Issues

​

Invalid API Key Error

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

• 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

# Increase timeout
client = MeibelClient(
    api_key=os.getenv("MEIBEL_API_KEY"),
    timeout=60.0,  # 60 seconds
)

const client = new MeibelClient({
  apiKey: process.env.MEIBEL_API_KEY,
  timeout: 60000,  // 60 seconds
});

​

SSL Certificate Errors

1. Update your certificates:
   pip install --upgrade certifi
   

​

Rate Limiting

​

429 Too Many Requests

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

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