API Reference
Rooms Management
Room Management Overview

API Room Management

The Room Management APIs provide complete control over video conferencing rooms in your Samvyo application. These endpoints allow you to create, configure, and manage rooms programmatically with advanced features for different meeting scenarios.

What You Can Achieve

Room Lifecycle Management

  • Create custom rooms with specific configurations and settings
  • Edit room settings to update permissions, features, and participants
  • Delete rooms when they're no longer needed
  • Fetch room details for monitoring and management

Advanced Room Configuration

  • Room type selection (p2p, conferencing, event) for different meeting styles
  • Participant limits (moderators, participants, viewers) for access control
  • Authentication requirements for secure meetings
  • Permanent room links for recurring meetings
  • Room passwords for additional security

Media & Feature Controls

  • Audio/Video status management for meeting controls
  • Screen sharing enablement for presentations
  • Chat functionality for participant communication
  • Recording capabilities with multiple formats (HLS, MP4) and resolutions (480p, 1080p, 4K)
  • Live streaming integration for broadcasting
  • Transcription services for meeting documentation

Advanced Recording Features

  • Multiple recording strategies (mergedA, mergedAV, AmergedAV)
  • Resolution selection for quality control (480p, 1080p, 2160p)
  • Selective recording (moderator only, participant only, or both)
  • Automatic recording with predefined strategies
  • Format flexibility (HLS for streaming, MP4 for download)

Participant Management

  • Room owner assignment with multiple owners support
  • Presenter controls for meeting facilitation
  • Privacy settings for participant protection
  • IP camera integration for external video sources
  • Upgrade request management for participant roles

Meeting Experience

  • Static room creation for consistent meeting spaces
  • Room agenda and scheduling capabilities
  • RTMP streaming for external platform integration
  • Recording strategies and resolution controls
  • Room status tracking (free, busy, etc.)

Available Endpoints

Room Creation & Configuration

  • Create Room - Set up new rooms with comprehensive settings
  • Edit Room - Modify existing room configurations and participants

Room Management

  • Fetch Room Details - Retrieve complete room information
  • Delete Room - Remove rooms from the system

Common Use Cases

Team Meetings

  1. Create conferencing rooms with multiple moderators
  2. Enable screen sharing and chat for collaboration
  3. Set participant limits based on team size
  4. Configure recording for meeting documentation

Client Presentations

  1. Set up rooms with presenter controls
  2. Enable live streaming for external audiences
  3. Configure recording for client deliverables
  4. Set authentication requirements for security

Training Sessions

  1. Create rooms with transcription enabled
  2. Set up multiple presenters for different topics
  3. Configure recording with specific formats and resolutions
  4. Enable chat for Q&A during sessions

Large-Scale Events

  1. Create event rooms with enhanced broadcasting features
  2. Configure high-resolution recording (4K) for quality content
  3. Set up automatic recording with merged audio/video strategy
  4. Enable live streaming for external audiences

Recurring Meetings

  1. Create permanent room links for consistency
  2. Set up static rooms for regular meetings
  3. Configure room owners for meeting management
  4. Set appropriate participant limits

Integration Examples

Calendar Integration

  • Automatically create rooms for scheduled meetings
  • Update room settings based on meeting type
  • Delete rooms after meeting completion

Learning Management System

  • Create training rooms with specific configurations
  • Enable recording and transcription for courses
  • Manage participant access based on enrollment

Customer Support Platform

  • Create support rooms with screen sharing enabled
  • Set up rooms with recording for quality assurance
  • Configure rooms for different support tiers

Event Management

  • Create rooms for virtual events with live streaming
  • Set up rooms with multiple presenters
  • Configure rooms for different event types
  • Enable high-quality recording for content creation

Room Types & Configurations

P2P Rooms

  • Direct peer-to-peer connections
  • Ideal for one-on-one meetings
  • Lower bandwidth requirements
  • Faster connection establishment

Conferencing Rooms

  • Multi-participant meetings
  • Centralized media processing
  • Better for large groups
  • Enhanced collaboration features

Event Rooms

  • Large-scale events and webinars
  • Enhanced broadcasting capabilities
  • Support for high-resolution recording
  • Optimized for one-to-many communication

Recording Strategies

mergedA (Merged Audio)

  • Combines audio from all participants
  • No video recording
  • Ideal for audio-only meetings or podcasts
  • Smaller file sizes

mergedAV (Merged Audio & Video)

  • Combines both audio and video from participants
  • Full meeting recording
  • Suitable for training and documentation
  • Higher quality output

AmergedAV (Automatic Merged Audio & Video)

  • Automatically starts recording when meeting begins
  • Combines audio and video streams
  • Perfect for hands-free recording
  • Consistent recording quality

Security & Privacy Features

  • Authentication requirements for secure access
  • Room passwords for additional protection
  • Participant privacy controls for data protection
  • Recording permissions for compliance
  • IP camera controls for external security

Performance Considerations

  • Participant limits based on room type
  • Media quality settings for bandwidth optimization
  • Recording format selection for storage efficiency
  • Live streaming configuration for broadcast quality
  • Room status monitoring for resource management
  • Resolution selection for optimal quality vs. storage balance

Use the sidebar to navigate to each endpoint for detailed API documentation, request/response formats, and code examples.