references/stream/gotchas.md
Stream Gotchas
Identify whether the failure occurs during upload, encoding, authorization, playback, or live ingestion before changing configuration. Read the linked requirements and error guidance for that stage.
| Symptom or check | Read | |---|---| | Unsupported file or upload constraint failure | Supported formats and upload requirements | | Large upload fails or restarts after interruption | Resumable upload requirements | | Stream cannot fetch an imported video | Upload via link requirements | | Upload finished but video is not playable | Upload progress tracking and processing error codes | | Private playback or embedding fails | Signed tokens, restrictions, and allowed origins | | Webhook signature verification fails | Verify the raw body and signature | | A custom HLS/DASH player behaves incorrectly | Own-player integration and manifest handling | | Live stream will not connect or playback buffers | Live troubleshooting | | Simulcast output does not behave as expected | Output configuration and limits | | Estimate storage or delivery costs | Stream pricing |
Check the actual response and current docs before adopting a retry policy or treating a video as ready. Keep credentials out of browser code and logs; use configuration.md for access setup and patterns.md for state decisions.