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

> Common issues and solutions for Meibel

# 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:
   ```bash theme={null}
   echo $MEIBEL_API_KEY
   ```
2. Check the key hasn't expired in the [Dashboard](https://console.meibel.ai)
3. Ensure you're using the correct header format:
   ```bash theme={null}
   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**:

<CodeGroup>
  ```python Python theme={null}
  # Increase timeout
  client = MeibelClient(
      api_key=os.getenv("MEIBEL_API_KEY"),
      timeout=60.0,  # 60 seconds
  )
  ```

  ```typescript TypeScript theme={null}
  const client = new MeibelClient({
    apiKey: process.env.MEIBEL_API_KEY,
    timeout: 60000,  // 60 seconds
  });
  ```
</CodeGroup>

### SSL Certificate Errors

**Problem**: SSL verification failures.

**Solutions**:

1. Update your certificates:
   ```bash theme={null}
   pip install --upgrade certifi
   ```

## Rate Limiting

### 429 Too Many Requests

**Problem**: Hitting rate limits.

**Solutions**:

1. Implement exponential backoff (see [Rate Limits](/api-reference/rate-limits))
2. Batch operations when possible
3. Consider upgrading your plan for higher limits

## SDK-Specific Issues

### Python: Import Errors

```bash theme={null}
pip install meibel
python -c "from meibel import MeibelClient; print('OK')"
```

### TypeScript: Build Errors

```bash theme={null}
npm install meibel
npx tsc --noEmit  # Check for type errors
```

### CLI: Command Not Found

```bash theme={null}
# 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](/api-reference/introduction)
2. **Support**: Contact [support@meibel.ai](mailto:support@meibel.ai) with:
   * Error messages and stack traces
   * Steps to reproduce the issue
   * SDK version and language version