> ## 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.

# Share meeting

> Share a meeting with specific users via email or generate a shareable link.

Shares a meeting with one or more recipients by email, or generates a shareable link with configurable permissions. Recipients receive an email notification with a link to the meeting. You can also generate a public or restricted link without specifying recipients.

<ParamField path="id" type="string" required>
  The unique meeting identifier (e.g., `mtg_8f3k2j1m4n5p`).
</ParamField>

<ParamField body="recipients" type="array">
  List of email addresses to share the meeting with. Each recipient receives an email invitation. Maximum 50 recipients per request.
</ParamField>

<ParamField body="permission" type="string" default="view">
  Permission level granted to recipients. One of `view` (read-only access to transcript, summary, and recording), `comment` (view plus ability to add comments and notes), or `edit` (full access including editing summary and action items).
</ParamField>

<ParamField body="generate_link" type="boolean" default="false">
  When `true`, generates a shareable link that can be distributed independently of the recipient list. The link inherits the specified `permission` level.
</ParamField>

<ParamField body="message" type="string">
  Optional personal message to include in the email notification sent to recipients. Maximum 500 characters.
</ParamField>

<ParamField body="expires_at" type="string">
  Optional expiration date for the share link in ISO 8601 format. After this time, the link becomes invalid. Only applies when `generate_link` is `true`.
</ParamField>

### Response

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

<ResponseField name="meeting_id" type="string">
  The ID of the shared meeting.
</ResponseField>

<ResponseField name="permission" type="string">
  The permission level granted: `view`, `comment`, or `edit`.
</ResponseField>

<ResponseField name="recipients" type="array">
  List of recipients and their invitation status.

  <Expandable title="Recipient object">
    <ResponseField name="email" type="string">
      The recipient's email address.
    </ResponseField>

    <ResponseField name="status" type="string">
      Invitation status: `sent`, `accepted`, or `pending`.
    </ResponseField>

    <ResponseField name="invited_at" type="string">
      ISO 8601 timestamp when the invitation was sent.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="link" type="object | null">
  The generated share link, or `null` if `generate_link` was `false`.

  <Expandable title="Link object">
    <ResponseField name="url" type="string">
      The shareable URL (e.g., `https://app.mavioapp.com/shared/mtg_8f3k2j1m4n5p?token=...`).
    </ResponseField>

    <ResponseField name="expires_at" type="string | null">
      ISO 8601 timestamp when the link expires. `null` if no expiration was set.
    </ResponseField>
  </Expandable>
</ResponseField>

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

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST https://api.mavioapp.com/v1/meetings/mtg_8f3k2j1m4n5p/share \
    -H "Authorization: Bearer mvo_live_abc123" \
    -H "Content-Type: application/json" \
    -d '{
      "recipients": ["alex@example.com", "jordan@example.com"],
      "permission": "comment",
      "generate_link": true,
      "message": "Here are the notes from our product sync."
    }'
  ```

  ```python Python theme={null}
  share = client.meetings.share(
      "mtg_8f3k2j1m4n5p",
      recipients=["alex@example.com", "jordan@example.com"],
      permission="comment",
      generate_link=True,
      message="Here are the notes from our product sync."
  )
  print(share.link.url)
  ```

  ```javascript Node.js theme={null}
  const share = await client.meetings.share('mtg_8f3k2j1m4n5p', {
    recipients: ['alex@example.com', 'jordan@example.com'],
    permission: 'comment',
    generateLink: true,
    message: 'Here are the notes from our product sync.',
  });
  console.log(share.link.url);
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "id": "shr_k1l2m3n4o5",
    "meeting_id": "mtg_8f3k2j1m4n5p",
    "permission": "comment",
    "recipients": [
      {
        "email": "alex@example.com",
        "status": "sent",
        "invited_at": "2026-04-14T09:30:00Z"
      },
      {
        "email": "jordan@example.com",
        "status": "sent",
        "invited_at": "2026-04-14T09:30:00Z"
      }
    ],
    "link": {
      "url": "https://app.mavioapp.com/shared/mtg_8f3k2j1m4n5p?token=shr_tok_x9y8z7w6",
      "expires_at": null
    },
    "created_at": "2026-04-14T09:30:00Z"
  }
  ```
</ResponseExample>