Troubleshooting

Common symptoms with their usual causes and fixes.

• Deploy failures — 412, 502, what each error code means.
• Auth and credentials — invalid_grant, audience mismatch, missing tenant key.
• Compile errors — dangling edges, undeclared llm_role, cycles.
• ScaiKey sync issues — admin scope missing, member-walk fallback, missing groups.
• HITL / checkpoint stuck — invocation paused but no review appears.
• 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.