POST
/
v1
/
ai
/
conversations
/
{conversation_id}
/
messages
curl -X POST https://api.mavioapp.com/v1/ai/conversations/conv_f6g7h8i9j0/messages \
  -H "Authorization: Bearer mvo_live_abc123" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "What did the team decide about the launch date?",
    "search_all_meetings": false
  }'

{
  "id": "msg_k1l2m3n4o5",
  "role": "assistant",
  "content": "The team decided to push the launch date to **May 15, 2026**. Sarah proposed the delay due to incomplete QA testing, and the team agreed unanimously during the discussion at the 14-minute mark.",
  "citations": [
    {
      "meeting_id": "mtg_8f3k2j1m4n5p",
      "meeting_title": "Weekly Product Sync",
      "timestamp": "00:14:32",
      "speaker": "Sarah Chen",
      "text": "I think we need to push the launch to May 15th. QA hasn't finished the regression suite and I don't want to ship with known gaps."
    },
    {
      "meeting_id": "mtg_8f3k2j1m4n5p",
      "meeting_title": "Weekly Product Sync",
      "timestamp": "00:15:10",
      "speaker": "James Park",
      "text": "Agreed. Let's lock in May 15th and communicate the updated timeline to stakeholders today."
    }
  ],
  "credits_used": 1,
  "created_at": "2026-04-14T11:21:05Z"
}
Sends a user message to an AI conversation and returns the AI’s response, including citations to specific meetings and transcript timestamps.
​
conversation_id
string
required
The ID of the conversation to send the message to.
​
content
string
required
The user’s question or message in natural language.
​
search_all_meetings
boolean
default:"false"
When true, Mavio AI searches across all accessible meetings regardless of conversation scope. When false, searches are limited to the conversation’s scoped meeting (if any).

​
Response

​
id
string
Unique message identifier.
​
role
string
Always assistant for the response message.
​
content
string
The AI’s response text in markdown format.
​
citations
array
Array of citations grounding the response.
​
credits_used
integer
Number of AI credits consumed by this query.
​
created_at
string
ISO 8601 timestamp.
curl -X POST https://api.mavioapp.com/v1/ai/conversations/conv_f6g7h8i9j0/messages \
  -H "Authorization: Bearer mvo_live_abc123" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "What did the team decide about the launch date?",
    "search_all_meetings": false
  }'

{
  "id": "msg_k1l2m3n4o5",
  "role": "assistant",
  "content": "The team decided to push the launch date to **May 15, 2026**. Sarah proposed the delay due to incomplete QA testing, and the team agreed unanimously during the discussion at the 14-minute mark.",
  "citations": [
    {
      "meeting_id": "mtg_8f3k2j1m4n5p",
      "meeting_title": "Weekly Product Sync",
      "timestamp": "00:14:32",
      "speaker": "Sarah Chen",
      "text": "I think we need to push the launch to May 15th. QA hasn't finished the regression suite and I don't want to ship with known gaps."
    },
    {
      "meeting_id": "mtg_8f3k2j1m4n5p",
      "meeting_title": "Weekly Product Sync",
      "timestamp": "00:15:10",
      "speaker": "James Park",
      "text": "Agreed. Let's lock in May 15th and communicate the updated timeline to stakeholders today."
    }
  ],
  "credits_used": 1,
  "created_at": "2026-04-14T11:21:05Z"
}
Each message consumes 1 AI credit. The response may take 2-8 seconds depending on the complexity of the question and the amount of meeting data to search.