riverside-cli

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 [e-mail] \
  --first-name Ada \
  --last-name Lovelace \
  --custom-fields-json '{"Company":"Acme"}'