Authentication
Common Patterns
Create and Use a Session
Upload and Process Files
API Endpoints Summary
Lens API
| Method | Endpoint | Description |
|---|---|---|
GET | /lens/info | Get lens summary info |
GET | /lens/metadata | Get detailed lens metadata |
POST | /lens/sessions/create | Create new lens session |
POST | /lens/sessions/destroy | Destroy lens session |
GET | /lens/sessions/info | Get sessions summary |
GET | /lens/sessions/metadata | Get active sessions metadata |
Files API
| Method | Endpoint | Description |
|---|---|---|
POST | /files/upload | Upload file |
GET | /files/list | List all files |
GET | /files/{file_id}/metadata | Get file metadata |
Error Handling
Common Error Codes
| Code | HTTP Status | Description | Solution |
|---|---|---|---|
UNAUTHORIZED | 401 | Invalid API key | Check API key format: Bearer YOUR_KEY |
INVALID_LENS_ID | 400 | Lens doesn’t exist | Get valid IDs from /lens/metadata |
SESSION_NOT_FOUND | 404 | Session destroyed/expired | Create new session |
RATE_LIMIT_EXCEEDED | 429 | Too many requests | Implement exponential backoff |
FILE_TOO_LARGE | 413 | File > 1GB | Compress or split file |
WebSocket Usage
Rate Limits
- Default: 100 requests per minute
- Burst: Up to 20 requests per second
- Sessions: 10 concurrent sessions per organization
- Files: 1GB max size, 100 files per hour
Quick Troubleshooting
1
Check API Key
2
List Available Lenses
3
Check Active Sessions
4
Clean Up Sessions