# Digital Samba for LLMs

> Digital Samba is a European-hosted, GDPR-compliant WebRTC video conferencing platform with no US sub-processors. It allows developers to embed fully-featured video calls into websites and applications, providing 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, quizzes, and chat functionality
- Breakout rooms and screen sharing
- RTMP restreaming to YouTube, Vimeo, and custom servers
- Custom branding and white-labeling options

## Authentication

Digital Samba uses API key authentication.
1. Register for a 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.

## LLM-Optimized Documentation

Curated, token-efficient documentation designed specifically for LLM consumption. These files distill the full API/SDK into structured references that fit within context windows:

- [Quick Start & Navigation](https://raw.githubusercontent.com/digitalsamba/digital-samba-skill/main/SKILL.md): Entry point with common tasks, decision trees, and file map
- [REST API Reference](https://raw.githubusercontent.com/digitalsamba/digital-samba-skill/main/api-reference.md): All endpoints with request/response examples, webhooks, pagination
- [SDK Reference](https://raw.githubusercontent.com/digitalsamba/digital-samba-skill/main/sdk-reference.md): JavaScript methods, events, properties, TypeScript types
- [Integration Patterns](https://raw.githubusercontent.com/digitalsamba/digital-samba-skill/main/patterns.md): Iframe embedding, React hooks, responsive sizing, error handling
- [JWT Authentication](https://raw.githubusercontent.com/digitalsamba/digital-samba-skill/main/jwt-tokens.md): Token generation, claims, expiration, security best practices

These files are actively maintained and updated when API or SDK changes are detected.

For Claude Code users: Install as a skill via `git submodule add https://github.com/digitalsamba/digital-samba-skill.git .claude/skills/digital-samba`

## Primary Use Cases

- **Server-Side**: Use the REST API for managing rooms, sessions, recordings, quizzes, restreaming, 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
- **Claude Code Skill Repository**: [https://github.com/digitalsamba/digital-samba-skill](https://github.com/digitalsamba/digital-samba-skill)
  - Full skill package with code examples in Node.js, Python, and React