Skip to main content
POST

Authorizations

​
Authorization
string
header
required

API key prefixed with mvra_live_. Create keys at Settings > Developer > API Keys.

Body

application/json
​
meeting_url
string<uri>
required

The meeting URL to record. Supports Zoom, Google Meet, Microsoft Teams, and Webex.

​
title
string

Optional title for the meeting

​
bot_name
string
default:Mavera Notetaker

Name displayed when the bot joins the meeting

​
join_at
string<date-time>

Schedule the bot to join at a specific time (ISO 8601 format). If not provided or in the past, the bot joins immediately.

​
workspace_id
string

Workspace to associate the meeting with. Uses default workspace if not specified.

Response

Meeting bot created successfully

​
id
string

Unique meeting identifier

​
object
enum<string>
Available options:
meeting
​
title
string | null
​
meeting_url
object

Meeting URL information

​
bot_name
string
​
join_type
enum<string>

Whether the bot joins immediately (adhoc) or at a scheduled time

Available options:
adhoc,
scheduled
​
join_at
string<date-time> | null

Scheduled join time (null for instant join)

​
status
enum<string>

Current status of the meeting recording

Available options:
pending,
joining_call,
in_waiting_room,
in_call_not_recording,
in_call_recording,
call_ended,
recording_done,
done,
fatal,
recording_permission_denied,
media_expired,
cancelled
​
platform
enum<string>

Meeting platform detected from URL

Available options:
zoom,
google_meet,
microsoft_teams,
webex
​
workspace_id
string
​
created_at
string<date-time>
​
updated_at
string<date-time>