Errors & rate limits

Jetwild uses conventional HTTP status codes and returns a structured error body on every failure.

Status codes

Error shape

{
"error": {
  "type": "payment_required",
  "code": "no_scans_remaining",
  "message": "Add Shield scans to continue.",
  "doc": "https://jetwild.dev/guides/errors"
}
}

Rate limits

Limits scale with plan. When you hit one you get a 429 with a Retry-After header (seconds). The SDKs retry these automatically with backoff.

Idempotency

Send an Idempotency-Key header on writes. Retried requests with the same key return the original result instead of duplicating work.