When things fail
| Class | Fix |
|---|---|
| Validation | Fix request shape |
| Interactive | Hosted /verify or VerifyGate |
| Async | Poll with backoff |
| Private read | Owner auth, retry |
| Transient | Backoff; Retry-After |
Polling Example
Private Proof Read Example
- Don’t loop-create on ambiguous errors - keep stored ids for resume.
- Say when a hosted step is required - avoid generic “error” only.