Start a new Meeting Buddy bot to join and record a meeting.
Start a new Meeting Buddy bot session. The bot joins the meeting asynchronously in the background. The API returns immediately with session details. Session status transitions: initializing -> joining -> active -> completed.
Supported meeting platforms: Microsoft Teams, Zoom, Google Meet, and Webex.
meeting_link string required
HTTPS URL to the meeting. Must be from a supported platform (Teams, Zoom, Google Meet, or Webex).
bot_name string optional · Defaults to "Meeting Buddy"
Display name for the bot in the meeting.
transcription_enabled boolean optional · Defaults to true
Enable real-time transcription of the meeting.
transcription_language string optional · Defaults to "en"
Language code for transcription (e.g., "en", "de", "fr").
Returns a Session object with the initial status set to initializing. The session includes identifiers, configuration, timestamps, and recording metadata fields (which are null until the session progresses).
- Bash
- Python
- Python
- JavaScript
curl -X POST https://api.aitronos.com/v1/meeting-buddy/sessions \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"meeting_link": "https://teams.microsoft.com/l/meetup-join/abc123",
"bot_name": "Meeting Buddy",
"transcription_enabled": true,
"transcription_language": "en"
}'| Field | Type | Description |
|---|---|---|
session_id | string | Unique session identifier (prefixed with mbsess_) |
organization_id | string | Organization that owns this session |
user_id | string | User who created the session |
meeting_link | string | Original meeting URL |
platform | string | Detected platform (teams, zoom, google_meet, webex) |
bot_name | string | Display name of the bot |
status | string | Current status (initializing, joining, active, recording, leaving, completed, failed) |
transcription_enabled | boolean | Whether transcription is active |
transcription_language | string | Language code for transcription |
debug_mode | boolean | Whether debug mode is enabled |
created_at | string | ISO 8601 creation timestamp |
updated_at | string | ISO 8601 last update timestamp |
join_timestamp | string or null | When the bot joined the meeting |
leave_timestamp | string or null | When the bot left the meeting |
total_duration_seconds | number or null | Total session duration in seconds |
segment_count | integer or null | Number of recording segments |
audio_file_count | integer or null | Number of audio files |
video_file_count | integer or null | Number of video files |
total_size_bytes | integer or null | Total recording size in bytes |
output_directory | string or null | Path to recording files |
error_message | string or null | Error description if session failed |
error_code | string or null | Error code if session failed |
metadata | object | Additional session metadata |
current_participants | object | Currently active participants |
participant_history | array | History of participant join/leave events |