# Digital Samba for LLMs

> Digital Samba is a GDPR-compliant WebRTC video conferencing platform that allows developers to embed fully-featured video calls into websites and applications. It provides both a REST API for server-side management and a JavaScript SDK for client-side integration.

This file provides a structured overview of Digital Samba's developer resources, optimized for Large Language Models.

## Core Features

- Create and manage video conferencing rooms with customizable settings
- Real-time WebRTC video/audio streaming with up to 2000 participants
- Cloud recording and transcription capabilities
- Live polling, Q&A, and chat functionality
- Breakout rooms and screen sharing
- Custom branding and white-labeling options

## Authentication

Digital Samba uses API key authentication. 
1. Register for an developer key at https://dashboard.digitalsamba.com
2. Use the developer key in the `Authorization: Bearer` header
3. See authentication guide: https://docs.digitalsamba.com/reference/#authentication

## Quick Start

1. Get your API credentials from the dashboard
2. Install the SDK: `npm install @digitalsamba/embedded-sdk`
3. Create a room via REST API
4. Generate a join token for a room guest
5. Embed the video call using the JavaScript SDK

Example implementations available at: https://github.com/digitalsamba/embedded-sdk/tree/main/examples

## Key Resources

- **OpenAPI Specification**: [https://developer.digitalsamba.com/rest-api/openapi.yaml](https://developer.digitalsamba.com/rest-api/openapi.yaml)
  - Complete OpenAPI 3.0 spec with all endpoints, request/response schemas, and examples. Use this to generate SDKs or understand the full API surface.
- **API Reference**: [https://docs.digitalsamba.com/reference/](https://docs.digitalsamba.com/reference/)
  - Interactive API documentation with code examples in multiple languages, authentication guides, and endpoint testing tools.
- **JavaScript SDK (GitHub)**: [https://github.com/digitalsamba/embedded-sdk](https://github.com/digitalsamba/embedded-sdk)
  - Source code, examples, TypeScript definitions, React/Vue integrations, and contribution guidelines for the client-side SDK.
- **Developer Portal**: [https://developer.digitalsamba.com](https://developer.digitalsamba.com)
  - Main hub for getting started guides, tutorials, best practices, and developer news.
- **NPM Package**: [https://www.npmjs.com/package/@digitalsamba/embedded-sdk](https://www.npmjs.com/package/@digitalsamba/embedded-sdk)
  - Official NPM package for the JavaScript SDK with installation instructions and version history.

## Primary Use Cases

- **Server-Side**: Use the REST API (via the OpenAPI spec) for managing rooms, sessions, recordings, and webhooks.
- **Client-Side**: Use the JavaScript SDK to embed and control the video call UI in your web application.

## Optional

- **Dashboard**: [https://dashboard.digitalsamba.com](https://dashboard.digitalsamba.com)
  - Web interface for managing rooms, viewing analytics, and configuring account settings