Skip to main content
POST
/
collection
/
{collection_id}
/
meeting
/
record
Record a meeting
curl --request POST \
  --url https://api.videodb.io/collection/{collection_id}/meeting/record \
  --header 'Content-Type: application/json' \
  --header 'x-access-token: <api-key>' \
  --data '
{
  "meeting_url": "https://meet.google.com/abc-def-ghi",
  "bot_name": "VideoDB Assistant",
  "meeting_title": "Weekly standup",
  "time_zone": "UTC",
  "bot_image_url": "https://example.com/bot-avatar.png",
  "realtime_stream": false,
  "callback_url": "https://webhook.example.com/callback",
  "callback_data": {}
}
'
{
  "success": true,
  "data": {
    "bot_id": "bot-12345"
  }
}
Start recording a meeting by sending a bot to join a video conferencing session. Supports Google Meet, Zoom, and other platforms.
  • The bot joins the meeting and records audio/video
  • Set bot_name to customize the display name in the meeting
  • Use bot_image_url to set a custom avatar for the bot
  • Enable realtime_stream for live streaming during the meeting
  • Use callback_url for webhook notifications on meeting events

Authorizations

x-access-token
string
header
required

API key for authentication (sk-xxx format)

Path Parameters

collection_id
string
required
Example:

"default"

Body

application/json
meeting_url
string
required
Example:

"https://meet.google.com/abc-def-ghi"

bot_name
string
default:VideoDB Assistant
Example:

"VideoDB Assistant"

meeting_title
string
Example:

"Weekly standup"

time_zone
string
default:UTC
Example:

"UTC"

bot_image_url
string
Example:

"https://example.com/bot-avatar.png"

realtime_stream
boolean
default:false
Example:

false

callback_url
string
Example:

"https://webhook.example.com/callback"

callback_data
object

Response

Meeting recording started

success
boolean
Example:

true

data
object