429 — Rate limited

A 429 can come from three sources: Guardian, your per-key cap, or the upstream provider. The error body tells you which one.

Guardian block

{
  "error": {
    "message": "Blocked by Guardian: duplicate_detector",
    "type": "guardian_block",
    "rule": "duplicate_detector",
    "retry_after_seconds": 60
  }
}

Fix the loop in your code, or raise/disable the Guardian threshold in Dashboard → Guardian.

Per-key cap hit

{
  "error": {
    "message": "Key daily spend cap reached ($5.00 / $5.00)",
    "type": "budget_error",
    "cap": "daily",
    "reset_at": "2026-04-14T00:00:00Z"
  }
}

Raise the cap in Settings → API Keys → Edit, or wait for the reset (midnight UTC for daily, first of the month for monthly).

Upstream rate limit

When the provider (OpenAI, Anthropic, …) returns a 429, HiWay forwards it with the original Retry-After header intact. HiWay does not currently auto-retry against a different provider — if you need cross-provider failover, open a ticket.