Using the APIs
Errors
Error Classes
The API uses conventional HTTP status classes: 4xx for client failures, 5xx for transient service issues. Error payloads include a stable code and a human-readable message.
| Status | Type | Meaning |
|---|---|---|
| 400 | invalid_request_error | Missing or malformed fields |
| 401 | authentication_error | Missing, invalid, or revoked API key |
| 402 | insufficient_quota | Daily free limit reached |
| 404 | invalid_request_error | Stilt not found or not accessible |
| 500 | api_error | Unexpected server error |
| 502 | execution_error | Stilt pipeline execution failed |
Retries
Retry idempotent requests with exponential backoff on 429, 502, 503, and 504. Do not blindly retry 400 or 401 responses — they indicate a problem with the request or credentials.
For stilt endpoints, the entire pipeline runs synchronously within a single request. Long-running stilts may time out after 20 minutes.