Common issues
Most ModelRiver issues fall into one of these categories:
- Authentication errors: Invalid or revoked API keys, missing provider credentials
- Provider failures: Timeout, rate limiting, or model availability issues
- Response issues: Unexpected output formats, structured output validation errors
- Webhook problems: Delivery failures, signature mismatches, timeout callbacks
Troubleshooting topics
- Quick fixes: Symptom-to-solution table for the most common errors
- Debugging tips: Systematic debugging strategies using Observability
- Contact support: When and how to reach the ModelRiver team
Testing without polluting logs
- Use the Workflow Playground (Projects → Playground). Responses appear inline and are not persisted to Request Logs.
- Provide the full payload the workflow expects, including
messages,inputs, ormetadata. - Adjust prompts, cache fields, or structured outputs and rerun until you are satisfied before deploying changes.
Next steps
- Observability: Deep-dive into request logs and timelines
- Security: Review credential management
- FAQ: Quick answers to common questions