Troubleshooting•stable•Updated 2026-07-06

Provider key errors

Diagnose and fix provider key errors.

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

Symptoms

  • Gateway route needs provider key or has provider key error.

Most common causes

  • Provider key missing, revoked or lacks model access.
  • Provider account quota or billing issue.

Fix

  1. Add or rotate the provider key.
  2. Test the route.
  3. Check provider account permissions and quota.

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