Gateway errors

Use this page when the symptom matches what you see in Kadryn or in your integration logs.

Symptoms

• Gateway requests fail or return non-success responses.
• Logs show authentication, policy, provider or rate-limit failures.

Most common causes

• Invalid Kadryn API key.
• Missing provider key.
• Policy or cap blocked the request.
• Provider rejected the request.
• Retry behavior is unsafe or too aggressive.

Fix

1. Check the API key prefix and workspace.
2. Open Developers → Gateway and review route readiness.
3. Open Logs & Traces and inspect the decision.
4. Fix provider keys or policy metadata.
5. Retry only when the error class is retryable.

Verify the fix

• Re-run the smallest safe test.
• Open Logs & Traces and search by request ID, trace ID or resource ID.
• Confirm the relevant dashboard card updates after refresh.
• Confirm no retry loop or duplicate delivery was created.

When to escalate

Escalate when the issue affects production traffic, billing-sensitive reporting, audit evidence, or any workflow where a customer-facing AI feature is blocked.

Related pages

• /docs/troubleshooting
• /docs/developer-docs/diagnostics