API Reference · Overview
Error Responses
Every endpoint can return 4xx and 5xx responses in addition to its
documented 2xx shape. All error responses share the same body:
{ "message": "<textual description of the error>" }
Common status codes and how to respond:
| Status | Meaning | Suggested action |
|---|---|---|
402 |
Billing issue — likely the free-tier quota has been exceeded | Upgrade or wait for quota reset |
403 |
Forbidden | Check your client credentials and token |
409 |
Resource conflict — usually a duplicate sample (Nyckel does not allow duplicate samples in a Function) | To re-annotate an existing sample, use the PUT annotation endpoint instead of POST-ing a new sample |
429 |
Throttled — you’ve exceeded either the rate or concurrency limit | Back off and retry; see API Throttling below |
500 |
Internal error | Retry with exponential backoff |
503 |
Service temporarily unavailable | Retry with exponential backoff |