Skip to main content

Status Polling Basics

Since presentation generation is asynchronous, you need to poll the status endpoint to check when generation is complete.

Status Values

Basic Polling Pattern

Bash Example

Python Example

Best Practices

Poll Interval

  • Recommended: 5-10 seconds between polls
  • Too Frequent: May hit rate limits
  • Too Infrequent: Slower user experience

Timeout Handling

Always set a maximum wait time:

Exponential Backoff

For better efficiency, use exponential backoff:

Error Handling

Progress Indicators

Show progress to users:

Webhook Alternative

For production applications, consider using webhooks (if available) instead of polling:

Check Status

Learn more about checking status

Error Handling Overview

See other error handling guides