---
title: Troubleshooting
path: troubleshooting
status: published
---

# Troubleshooting

Common symptoms with their usual causes and fixes.

- **[Deploy failures](./troubleshooting/deploy-failures)** — 412, 502, what each `error` code means.
- **[Auth and credentials](./troubleshooting/auth-and-credentials)** — invalid_grant, audience mismatch, missing tenant key.
- **[Compile errors](./troubleshooting/compile-errors)** — dangling edges, undeclared llm_role, cycles.
- **[ScaiKey sync issues](./troubleshooting/scaikey-sync)** — admin scope missing, member-walk fallback, missing groups.
- **[HITL / checkpoint stuck](./troubleshooting/hitl-stuck)** — invocation paused but no review appears.
- **[Draft restore](./troubleshooting/draft-restore)** — refresh loses my work / draft restores stale content.

Can't find a fix here? File an issue at your tenant's support channel with the request ID + error detail. The structured `detail.error` codes the API returns are designed to be greppable.