Webhook Bundle Delivery

Your demo assets delivered to your webhook — not stuck in a dashboard

AI Screen Recorder is API-first. You submit a job, and when it completes, we send the results to your webhook. No polling, no dashboard login required, no manual downloads.

What’s in the bundle

Each completed job produces a zip archive containing:

• Final videos — chunk-N-final.mp4 for each feature (branded intro/outro + audio)
• Hero stills — keyframe PNG extracts for each chunk
• Voiceover scripts — chunk-N-script.txt for re-recording or editing
• Audio files — chunk-N-audio.mp3 (ElevenLabs synthesis, raw)
• Job manifest — JSON listing every asset with its status, duration, and cost

Signed URLs with 7-day TTL

Bundle URLs are signed with short-lived credentials. Direct access to your R2 bucket is never exposed. If you need to renew access, a single API call to GET /v1/jobs/:id/bundle issues fresh signed URLs.

Retention periods are configurable per client — raw recordings are purged after 7 days, edited output after 30 days, bundles after 90 days by default.

Webhook security

Every webhook POST is signed with HMAC-SHA256 using the secret you register. The signature is included in the X-AISR-Signature header alongside an X-AISR-Timestamp. Verify both on your end — and reject any delivery where the timestamp skew exceeds 5 minutes.

Real-time progress via SSE

If you want live progress during a job, the GET /v1/jobs/:id/events endpoint streams Server-Sent Events with the same payload structure as webhook deliveries — useful for building a status UI or triggering intermediate actions during recording.

Partial success handling

If some chunks fail after all retries, the job status becomes partial_success. You still receive a bundle with everything that succeeded, plus a manifest listing which chunks failed and why. Retry only the failed chunks with POST /v1/jobs/:id/rerun-chunks.