Gateway Errors

Symptom

A request routed through Kadryn Gateway fails, times out, returns a provider error, or is blocked by a policy.

Likely causes

• The Kadryn API key is missing, expired or scoped to the wrong workspace.
• The provider key is missing or revoked.
• Required project or environment metadata is missing.
• A budget cap or guardrail blocked the request.
• The provider returned a retryable error or rate limit.

How to confirm

Open Developers > Logs & Traces and search for the gateway request ID. Review authentication status, provider status, policy decision and normalized usage fields.

How to fix

• Fix authentication before debugging provider behavior.
• Verify provider key status.
• Add missing project and environment metadata.
• Review the matching Guardrails decision if the request was blocked.
• Retry only when the operation is retry-safe and an idempotency key is present.

Escalation path

Export the timestamp, workspace, project, gateway request ID, provider request ID, model, status code and policy decision before contacting support.