Skip to main content
POST
Beta Feature: This endpoint is currently in beta. Features and specifications may change.
Adhoc sessions allow you to create temporary assistants with custom configurations without persisting them. Perfect for testing and dynamic use cases.
string
required
Display name for the user participant
string
Optional custom room name. If not provided, a unique room name will be generated
object
required
Complete assistant configuration for this session

Use Cases

Adhoc sessions are perfect for:
  • A/B Testing - Test different configurations without creating multiple assistants
  • Personalization - Create custom experiences based on user preferences
  • Multi-language Support - Dynamic language selection per session
  • Role-based Assistants - Different behaviors for different user types
  • Temporary Demos - One-off demonstrations with specific settings
  • Development - Quick testing of configurations before persisting

Benefits

  • No need to create and manage multiple assistant configurations
  • Instant configuration changes without database updates
  • Perfect for dynamic, context-aware assistants
  • Reduced storage overhead for temporary configurations

Limitations

Adhoc sessions are temporary and their configurations are not persisted. Each session requires the full configuration to be provided.
  • Configuration must be complete (no partial configs)
  • No configuration history or versioning
  • Cannot be referenced by ID for future sessions
  • May have different rate limits than persisted assistants

Configuration Examples

Customer Support with Dynamic Language

Educational Assistant with Grade Level