> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mavioapp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create conversation

> Create a new AI conversation, optionally scoped to a specific meeting.

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.

<ParamField body="meeting_id" type="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.
</ParamField>

<ParamField body="title" type="string">
  Optional title for the conversation. If not provided, Mavio auto-generates a title based on the first message. Maximum 200 characters.
</ParamField>

### Response

<ResponseField name="id" type="string">
  Unique conversation identifier (e.g., `cnv_a1b2c3d4e5`).
</ResponseField>

<ResponseField name="meeting_id" type="string | null">
  The meeting this conversation is scoped to, or `null` for unscoped conversations.
</ResponseField>

<ResponseField name="title" type="string | null">
  Conversation title. May be `null` until the first message is sent and a title is auto-generated.
</ResponseField>

<ResponseField name="message_count" type="integer">
  Number of messages in the conversation (starts at 0).
</ResponseField>

<ResponseField name="created_at" type="string">
  ISO 8601 timestamp when the conversation was created.
</ResponseField>

<ResponseField name="updated_at" type="string">
  ISO 8601 timestamp when the conversation was last active.
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  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"
    }'
  ```

  ```python Python theme={null}
  conversation = client.ai.create_conversation(
      meeting_id="mtg_8f3k2j1m4n5p",
      title="Questions about product sync"
  )
  print(f"Conversation: {conversation.id}")
  ```

  ```javascript Node.js theme={null}
  const conversation = await client.ai.createConversation({
    meetingId: 'mtg_8f3k2j1m4n5p',
    title: 'Questions about product sync',
  });
  console.log(`Conversation: ${conversation.id}`);
  ```
</RequestExample>

<ResponseExample>
  ```json 201 theme={null}
  {
    "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"
  }
  ```
</ResponseExample>