Poll case progress updates (HTTP fallback)
Cases
Poll Case Analysis Progress
Retrieve case analysis progress events via incremental polling (fallback for streaming).
GET
Poll case progress updates (HTTP fallback)
Retrieve case analysis progress events via incremental polling. This endpoint also serves as a fallback when Server-Sent Events (SSE) streaming is not available. It returns only the newest events since the specified
last_event_id, making it efficient for periodic polling.
When to Use Polling vs Streaming
Use Streaming (SSE) When:
- Real-time updates are critical.
- Low-latency progress monitoring is needed.
- Network supports persistent connections.
Use Polling When:
- SSE streaming fails or is blocked by network restrictions.
- Simple periodic updates are sufficient.
- Low-latency is not a requirement.
Best Practices
- Incremental Polling: Always use
last_event_idto avoid receiving duplicate events and reduce response size. - Polling Intervals: Use 2-5 second intervals to balance responsive updates with server load.
- Timeout Handling: Implement reasonable timeouts (e.g., 10-15 minutes) for long-running analyses.