Errors & Recovery
ReelForge exposes structured failures so agents/builders can recover predictably.
Error model
- synchronous API validation/auth/billing errors
- asynchronous worker errors on failed jobs
- webhook delivery retries/failures (without mutating core render status)
Common recovery pattern
- inspect error code and message
- correct payload/data issue
- retry safely using idempotency key semantics
Typical failure classes
- invalid asset URL / unreachable media
- impossible trim math
- out-of-bounds timeline placement
- caption alignment failure
Use validation before render to catch many issues earlier.