Managing Recordings

This page covers how to list, access, and delete recordings for your calls. These operations apply to all recording types (composite, individual, and raw).

List recordings

This endpoint returns the list of recordings for a call. When using Stream S3 as storage (default) all links are signed and expire after 2 weeks.

call.listRecordings();

call.list_recordings()

call.ListRecordings(ctx, &getstream.ListRecordingsRequest{})

curl "https://video.stream-io-api.com/api/v2/video/call/${CALL_TYPE}/${CALL_ID}/recordings?api_key=${API_KEY}" \
    -H "Authorization: ${TOKEN}" \
    -H "stream-auth-type: jwt"

Delete recording

This endpoint allows you to delete a call recording. Recordings will only be deleted if they are stored on Stream's side (default).

An error will be returned if the recording doesn't exist.

call.deleteRecording({ session: "<session id>", filename: "<filename>" });

call.delete_recording(sessionID, filename)

call.DeleteRecording(ctx, "session_id", "filename", &getstream.DeleteRecordingRequest{})

curl -X DELETE "https://video.stream-io-api.com/video/call/${CALL_TYPE}/${CALL_ID}/${SESSION_ID}/recordings/${FILENAME}?api_key=${API_KEY}" \
     -H "Authorization: ${JWT_TOKEN}" \
     -H "stream-auth-type: jwt"

User permissions

The following permissions are checked when users interact with the recording management API:

• ListRecordings required to retrieve the list of recordings
• DeleteRecording required to delete an existing recording (including its files if stored using Stream S3 storage)