Errors & Limits
SUMUN uses HTTP status codes together with machine-readable error codes. Integrations should branch on those values instead of matching human-readable messages.
| HTTP status | Meaning |
|---|---|
400 | Invalid input or unsupported request shape |
401 | Missing or invalid API key |
403 | API key does not have the required scope |
404 | Resource or analysis result not found |
409 | Request conflicts with the current resource state |
413 | Request exceeds an accepted size limit |
429 | Quota, concurrency, or rate limit reached |
5xx | SUMUN or an upstream dependency failed |
Retry transient 429 and 5xx responses with exponential backoff and jitter. Respect Retry-After when present. Do not retry invalid input, authentication, or scope errors without correcting the request.
The usage dashboard is the source of truth for the current daily quota and remaining request units during open beta.