Riverside API

POST https://cotlet.dev/api/v1/riverside/list_studios

Returns every studio in your account, the ones you own and the ones you were added to. Use studio_id from each item in the other calls. Recording type is audio and video or audio only, as set in the studio.

Parameters

No parameters.

Request

curl -X POST https://cotlet.dev/api/v1/riverside/list_studios \
  -H "Authorization: Bearer $COTLET_API_KEY"

result = client.call("riverside", "list_studios")

const result = await cotlet.call('riverside', 'list_studios');

cotlet call riverside list_studios

Example response

{
  "studios": [
    {
      "studio_id": "std_8f2k41",
      "name": "The Product Hour",
      "recording_type": "audio_video",
      "studio_url": "https://riverside.com/studio/the-product-hour"
    },
    {
      "studio_id": "std_2m9c07",
      "name": "Founders Q&A",
      "recording_type": "audio_only",
      "studio_url": "https://riverside.com/studio/founders-qa"
    }
  ]
}

POST https://cotlet.dev/api/v1/riverside/list_sessions

Lists scheduled sessions in start order, soonest first. Each item has the invited guests, producers and audience members with their roles. Pass session_id to update_session, invite_guest or cancel_session.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/riverside/list_sessions \
  -H "Authorization: Bearer $COTLET_API_KEY"

result = client.call("riverside", "list_sessions")

const result = await cotlet.call('riverside', 'list_sessions');

cotlet call riverside list_sessions

Example response

{
  "sessions": [
    {
      "session_id": "ses_3vq9x7",
      "studio_id": "std_8f2k41",
      "name": "Episode 42: Pricing your first product",
      "start": "2026-10-15T15:00:00+01:00",
      "end": "2026-10-15T16:00:00+01:00",
      "invited": [
        {
          "email": "guest@example.com",
          "role": "guest"
        }
      ]
    }
  ],
  "next_cursor": null
}

POST https://cotlet.dev/api/v1/riverside/get_invite_links

Returns the studio link for each role. Guest and producer links let people join the studio; the audience link works only while audience public access is turned on in the studio. A link you share yourself does not expire, unlike the link in an invite email.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/riverside/get_invite_links \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"studio_id":"studio_8c41d2"}'

result = client.call("riverside", "get_invite_links", {"studio_id":"studio_8c41d2"})

const result = await cotlet.call('riverside', 'get_invite_links', {"studio_id":"studio_8c41d2"});

cotlet call riverside get_invite_links --data '{"studio_id":"studio_8c41d2"}'

Example response

{
  "studio_id": "std_8f2k41",
  "links": {
    "guest": "https://riverside.com/studio/the-product-hour?t=guest-token",
    "producer": "https://riverside.com/studio/the-product-hour?t=producer-token",
    "audience": null
  }
}

POST https://cotlet.dev/api/v1/riverside/list_recordings

Lists recordings across your studios, newest first. Filter by studio or by date to find the latest episode. Upload status shows whether each participant's files are fully uploaded. Pass recording_id to get_recording, get_transcript and download_tracks.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/riverside/list_recordings \
  -H "Authorization: Bearer $COTLET_API_KEY"

result = client.call("riverside", "list_recordings")

const result = await cotlet.call('riverside', 'list_recordings');

cotlet call riverside list_recordings

Example response

{
  "recordings": [
    {
      "recording_id": "rec_71d3ab",
      "studio_id": "std_8f2k41",
      "title": "Episode 41: Launch week",
      "recorded_at": "2026-10-08T15:02:00+01:00",
      "duration_seconds": 3412,
      "participants": [
        "Host",
        "Guest"
      ],
      "upload_status": "complete"
    }
  ],
  "next_cursor": "eyJvZmZzZXQiOjIwfQ"
}

POST https://cotlet.dev/api/v1/riverside/get_recording

Returns one recording and the tracks of each participant. Each track has a type (audio or video, and screen share when one was recorded) and an upload status. Read it before download_tracks to see whether every track has finished uploading.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/riverside/get_recording \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"recording_id":"recording_8c41d2"}'

result = client.call("riverside", "get_recording", {"recording_id":"recording_8c41d2"})

const result = await cotlet.call('riverside', 'get_recording', {"recording_id":"recording_8c41d2"});

cotlet call riverside get_recording --data '{"recording_id":"recording_8c41d2"}'

Example response

{
  "recording_id": "rec_71d3ab",
  "title": "Episode 41: Launch week",
  "duration_seconds": 3412,
  "participants": [
    {
      "name": "Host",
      "tracks": [
        {
          "type": "audio",
          "upload_status": "complete"
        },
        {
          "type": "video",
          "upload_status": "complete"
        }
      ]
    },
    {
      "name": "Guest",
      "tracks": [
        {
          "type": "audio",
          "upload_status": "complete"
        },
        {
          "type": "video",
          "upload_status": "uploading"
        }
      ]
    }
  ]
}

POST https://cotlet.dev/api/v1/riverside/get_transcript

Returns the transcript Riverside made for one recording, in speaker order with timestamps. Use format srt for subtitle files and txt for plain reading. The call fails if the recording has no transcript yet.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/riverside/get_transcript \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"recording_id":"recording_8c41d2"}'

result = client.call("riverside", "get_transcript", {"recording_id":"recording_8c41d2"})

const result = await cotlet.call('riverside', 'get_transcript', {"recording_id":"recording_8c41d2"});

cotlet call riverside get_transcript --data '{"recording_id":"recording_8c41d2"}'

Example response

{
  "recording_id": "rec_71d3ab",
  "format": "txt",
  "text": "[00:00:04] Host: Welcome back to The Product Hour.\n[00:00:09] Guest: Thanks for having me."
}

POST https://cotlet.dev/api/v1/riverside/download_tracks

Returns one download link per participant for the file type you choose: raw video, aligned video, raw audio or compressed audio, the options in the Riverside Download menu. Tracks that are still uploading are listed without a link. Screen share tracks in high quality exist only when the screen share was recorded with the Mac app. Edited tracks are not included; they come from an edit export.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/riverside/download_tracks \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"recording_id":"rec_71d3ab","file_type":"raw_audio"}'

result = client.call("riverside", "download_tracks", {"recording_id":"rec_71d3ab","file_type":"raw_audio"})

const result = await cotlet.call('riverside', 'download_tracks', {"recording_id":"rec_71d3ab","file_type":"raw_audio"});

cotlet call riverside download_tracks --data '{"recording_id":"rec_71d3ab","file_type":"raw_audio"}'

Example response

{
  "recording_id": "rec_71d3ab",
  "file_type": "raw_audio",
  "files": [
    {
      "participant": "Host",
      "url": "https://downloads.example.com/rec_71d3ab/host.wav",
      "status": "ready"
    },
    {
      "participant": "Guest",
      "url": "https://downloads.example.com/rec_71d3ab/guest.wav",
      "status": "ready"
    }
  ]
}

POST https://cotlet.dev/api/v1/riverside/create_studio

Creates a studio with the name and recording type you give. Studios count against the limit of your Riverside plan, so a new one can use up a slot. By default you confirm each call; you can switch that off for this tool.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/riverside/create_studio \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Jane Doe"}'

result = client.call("riverside", "create_studio", {"name":"Jane Doe"})

const result = await cotlet.call('riverside', 'create_studio', {"name":"Jane Doe"});

cotlet call riverside create_studio --data '{"name":"Jane Doe"}'

Example response

{
  "studio_id": "std_5t8n22",
  "name": "Interview Series",
  "recording_type": "audio_video",
  "studio_url": "https://riverside.com/studio/interview-series"
}

POST https://cotlet.dev/api/v1/riverside/schedule_session

Adds a session at the start and end time you give, in the time zone you set. Each guest in guest_emails gets an invite email with the session details and the studio link; the emailed link works until 24 hours after the start. Only the host, account owner, admins, directors and editors can schedule. By default you confirm each call; you can switch that off for this tool.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/riverside/schedule_session \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"studio_id":"std_8f2k41","name":"Episode 42: Pricing your first product","start":"2026-10-15T15:00:00+01:00","end":"2026-10-15T16:00:00+01:00","guest_emails":["guest@example.com"]}'

result = client.call("riverside", "schedule_session", {"studio_id":"std_8f2k41","name":"Episode 42: Pricing your first product","start":"2026-10-15T15:00:00+01:00","end":"2026-10-15T16:00:00+01:00","guest_emails":["guest@example.com"]})

const result = await cotlet.call('riverside', 'schedule_session', {"studio_id":"std_8f2k41","name":"Episode 42: Pricing your first product","start":"2026-10-15T15:00:00+01:00","end":"2026-10-15T16:00:00+01:00","guest_emails":["guest@example.com"]});

cotlet call riverside schedule_session --data '{"studio_id":"std_8f2k41","name":"Episode 42: Pricing your first product","start":"2026-10-15T15:00:00+01:00","end":"2026-10-15T16:00:00+01:00","guest_emails":["guest@example.com"]}'

Example response

{
  "session_id": "ses_3vq9x7",
  "studio_id": "std_8f2k41",
  "status": "scheduled",
  "start": "2026-10-15T15:00:00+01:00",
  "invited": [
    {
      "email": "guest@example.com",
      "role": "guest",
      "email_sent": true
    }
  ]
}

POST https://cotlet.dev/api/v1/riverside/update_session

Changes the fields you pass and leaves the rest. When the date or time changes, Riverside emails the guests, producer and audience members that the session was updated, and the Google Calendar invite updates automatically. By default you confirm each call; you can switch that off for this tool.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/riverside/update_session \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"session_id":"ses_3vq9x7","start":"2026-10-16T11:00:00+01:00","end":"2026-10-16T12:00:00+01:00"}'

result = client.call("riverside", "update_session", {"session_id":"ses_3vq9x7","start":"2026-10-16T11:00:00+01:00","end":"2026-10-16T12:00:00+01:00"})

const result = await cotlet.call('riverside', 'update_session', {"session_id":"ses_3vq9x7","start":"2026-10-16T11:00:00+01:00","end":"2026-10-16T12:00:00+01:00"});

cotlet call riverside update_session --data '{"session_id":"ses_3vq9x7","start":"2026-10-16T11:00:00+01:00","end":"2026-10-16T12:00:00+01:00"}'

Example response

{
  "session_id": "ses_3vq9x7",
  "status": "updated",
  "start": "2026-10-16T11:00:00+01:00",
  "end": "2026-10-16T12:00:00+01:00",
  "notified": [
    "guest@example.com"
  ]
}

POST https://cotlet.dev/api/v1/riverside/invite_guest

Adds one person to a scheduled session and sends them an invite email with the session details and the studio link. Role is guest by default. Inviting the same email again resends the invite. By default you confirm each call; you can switch that off for this tool.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/riverside/invite_guest \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"session_id":"session_8c41d2","email":"jane@example.com"}'

result = client.call("riverside", "invite_guest", {"session_id":"session_8c41d2","email":"jane@example.com"})

const result = await cotlet.call('riverside', 'invite_guest', {"session_id":"session_8c41d2","email":"jane@example.com"});

cotlet call riverside invite_guest --data '{"session_id":"session_8c41d2","email":"jane@example.com"}'

Example response

{
  "session_id": "ses_3vq9x7",
  "email": "producer@example.com",
  "role": "producer",
  "email_sent": true
}

POST https://cotlet.dev/api/v1/riverside/cancel_session

Cancels the session and removes it from the Planner and the project folder. Recordings that were already made stay in your account. Cancelling cannot be undone with one call; schedule the session again to restore it. By default you confirm each call; you can switch that off for this tool.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/riverside/cancel_session \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"session_id":"session_8c41d2"}'

result = client.call("riverside", "cancel_session", {"session_id":"session_8c41d2"})

const result = await cotlet.call('riverside', 'cancel_session', {"session_id":"session_8c41d2"});

cotlet call riverside cancel_session --data '{"session_id":"session_8c41d2"}'

Example response

{
  "session_id": "ses_3vq9x7",
  "status": "cancelled"
}