Troubleshooting
Diagnose authentication, access, validation, conflicts, and billing failures.
| Symptom | Check |
|---|---|
| 401 / unauthenticated | epismo whoami, token expiry, login state |
| 403 / forbidden | workspace, scope, owner role, object ACL |
| 404 / not found | ID, archive state, current ACL; hidden objects may also appear absent |
| 409 / conflict | re-read the latest Case, Task, or Playbook Version and reconsider the change |
| 422 / validation | input schema, required fields, Step IDs, resource refs |
| 402 / insufficient credit | active workspace and credit balance |
| 429 / rate limit | stop immediate loops, back off, then retry |
For CLI failures, inspect the stderr error code, message, and retryable fields. For MCP, classify a tool failure as authentication, input, or concurrency before acting.
Reuse an idempotency key only for an identical uncertain request. Use a new key after correcting validation or rebuilding intent from fresh state.