victorious-room-41442
02/17/2026, 5:52 AMtall-airline-16756
02/17/2026, 5:52 AMtall-airline-16756
02/17/2026, 5:53 AMegress_ended webhook that contains the final file location (or backup info if an upload failed). You can use that URL to download or view the file.
Where recordings are stored
• Cloud storage upload: If you configured egress with cloud storage (S3, GCS, etc.), the recording is uploaded directly to that bucket. Example S3 configuration when starting egress:
Output: &livekit.EncodedFileOutput_S3{
S3: &livekit.S3Upload{
AccessKey: "key",
Secret: "secret",
Bucket: "bucket",
Region: "bucket region",
},
}
• Backup storage: If the cloud upload fails and backup egress is enabled, LiveKit saves the recording to a backup storage bucket for up to 7 days. The backup location is included in the egress_ended webhook.
How to view/download recordings
1. Check the egress_ended webhook event for the recording URL or backup manifest. The webhook payload contains the file location (and backupStorageUsed: true if backup was used).
2. If backup was used, fetch the manifestLocation in the webhook. The manifest is a JSON listing files and their temporary download URLs.
3. Use the provided URL(s) to download or stream the file from your configured bucket or from the backup URL.
Important notes
• LiveKit doesn’t store recordings by default; files go to your configured destination.
• Backup recording URLs are temporary (valid for 7 days).
• Backup recordings are visible in the LiveKit Cloud dashboard under egress session details (the Destinations section) where you can copy the file URL.
If you’d like, I can help with next steps — pick one:
• Walkthrough how to set up S3/GCS uploads for egress (show the config you need).
• Show an example of the egress_ended webhook payload and where to find the file URL.
• Help check a specific egress session if you can share the egress ID or webhook payload (or tell me how you started the recording). Sources: Universal Egress | Backup Egress Recordings | Security | LiveKitvictorious-room-41442
02/17/2026, 5:53 AMtall-airline-16756
02/17/2026, 5:53 AMegress_ended webhook and use the manifest URL to download backup files for transfer.
• Help outline a small script or lambda function to move files from S3 to Azure Blob Storage.
Which option would you prefer or do you want to share how you currently start egress (egress config or egress ID) so I can give a more concrete example?
Sources: Universal Egress | Backup Egress Recordings | Azure OpenAI TTS plugin guide | LiveKit Documentation