POST
/
v1
/
ai
/
conversations
curl -X POST https://api.mavioapp.com/v1/ai/conversations \
  -H "Authorization: Bearer mvo_live_abc123" \
  -H "Content-Type: application/json" \
  -d '{
    "meeting_id": "mtg_8f3k2j1m4n5p",
    "title": "Questions about product sync"
  }'

{
  "id": "cnv_a1b2c3d4e5",
  "meeting_id": "mtg_8f3k2j1m4n5p",
  "title": "Questions about product sync",
  "message_count": 0,
  "created_at": "2026-04-14T09:00:00Z",
  "updated_at": "2026-04-14T09:00:00Z"
}
Creates a new AI conversation session. You can scope the conversation to a specific meeting so the AI only references that meeting’s transcript and summary, or create an unscoped conversation that can search across all your meetings.
​
meeting_id
string
Optional meeting ID to scope the conversation to a specific meeting. When provided, the AI assistant will only reference content from this meeting. When omitted, the AI can search across all your meetings.
​
title
string
Optional title for the conversation. If not provided, Mavio auto-generates a title based on the first message. Maximum 200 characters.

​
Response

​
id
string
Unique conversation identifier (e.g., cnv_a1b2c3d4e5).
​
meeting_id
string | null
The meeting this conversation is scoped to, or null for unscoped conversations.
​
title
string | null
Conversation title. May be null until the first message is sent and a title is auto-generated.
​
message_count
integer
Number of messages in the conversation (starts at 0).
​
created_at
string
ISO 8601 timestamp when the conversation was created.
​
updated_at
string
ISO 8601 timestamp when the conversation was last active.
curl -X POST https://api.mavioapp.com/v1/ai/conversations \
  -H "Authorization: Bearer mvo_live_abc123" \
  -H "Content-Type: application/json" \
  -d '{
    "meeting_id": "mtg_8f3k2j1m4n5p",
    "title": "Questions about product sync"
  }'

{
  "id": "cnv_a1b2c3d4e5",
  "meeting_id": "mtg_8f3k2j1m4n5p",
  "title": "Questions about product sync",
  "message_count": 0,
  "created_at": "2026-04-14T09:00:00Z",
  "updated_at": "2026-04-14T09:00:00Z"
}