| name | riverside-cli |
| description | Use the local Riverside.fm Business API CLI to list productions, recordings, exports, download media/transcripts, and manage webinar registrants. |
Riverside CLI
Use the riverside binary for Riverside.fm Business API tasks. It authenticates with a Bearer token from --api-key, RIVERSIDE_API_KEY, or ~/.config/riverside/config.yaml after running riverside auth <api-key>.
Output
Default output is JSON. For agent workflows, keep JSON unless a table or CSV is specifically useful:
riverside recording list --project-id <project-id>
riverside export list --studio-id <studio-id> --output table
riverside registrant list --event-id <event-id> --limit 100
Commands
riverside workspace list lists productions with studios and projects.riverside recording list|get|delete works with recordings.riverside export list|get|delete works with exported edits.riverside download file|export|transcription writes media or transcript bytes to --output-file.riverside registrant create|list manages webinar registrants for an event.
Downloads
Download commands require --output-file; use - only when stdout should contain the raw file bytes.
riverside download file --id <file-id> --output-file ./track.wav
riverside download export --id <export-id> --output-file ./export.mp4
riverside download transcription --recording-id <recording-id> --type srt --output-file ./transcript.srt
Webinar Registrants
Create accepts simple flags plus optional custom fields JSON. Use --body-json or --body-file when you need to send the complete request body.
riverside registrant create \
--event-id <event-id> \
--email ada@example.com \
--first-name Ada \
--last-name Lovelace \
--custom-fields-json '{"Company":"Acme"}'
