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

# Delete meeting

> Delete a meeting and optionally its associated transcript, summary, and recording data.

Deletes a meeting by ID. By default, this performs a **soft delete** -- the meeting is marked as deleted and excluded from list results, but the data is retained for 30 days in case you need to recover it.

To permanently delete a meeting and all associated data immediately, set `permanent` to `true`.

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

<ParamField query="permanent" type="boolean" default="false">
  When `true`, permanently deletes the meeting and all associated data (transcript, summary, recording, action items). This action cannot be undone.
</ParamField>

### Response

<ResponseField name="id" type="string">
  The ID of the deleted meeting.
</ResponseField>

<ResponseField name="deleted" type="boolean">
  Always `true` on success.
</ResponseField>

<ResponseField name="permanent" type="boolean">
  Whether the deletion was permanent.
</ResponseField>

<ResponseField name="recoverable_until" type="string | null">
  ISO 8601 timestamp until which the meeting can be recovered. `null` if permanently deleted.
</ResponseField>

<RequestExample>
  ```bash Soft delete theme={null}
  curl -X DELETE https://api.mavioapp.com/v1/meetings/mtg_8f3k2j1m4n5p \
    -H "Authorization: Bearer mvo_live_abc123"
  ```

  ```bash Permanent delete theme={null}
  curl -X DELETE "https://api.mavioapp.com/v1/meetings/mtg_8f3k2j1m4n5p?permanent=true" \
    -H "Authorization: Bearer mvo_live_abc123"
  ```

  ```python Python theme={null}
  # Soft delete (recoverable for 30 days)
  client.meetings.delete("mtg_8f3k2j1m4n5p")

  # Permanent delete
  client.meetings.delete("mtg_8f3k2j1m4n5p", permanent=True)
  ```

  ```javascript Node.js theme={null}
  // Soft delete (recoverable for 30 days)
  await client.meetings.delete('mtg_8f3k2j1m4n5p');

  // Permanent delete
  await client.meetings.delete('mtg_8f3k2j1m4n5p', { permanent: true });
  ```
</RequestExample>

<ResponseExample>
  ```json 200 — Soft delete theme={null}
  {
    "id": "mtg_8f3k2j1m4n5p",
    "deleted": true,
    "permanent": false,
    "recoverable_until": "2026-05-10T14:52:08Z"
  }
  ```

  ```json 200 — Permanent delete theme={null}
  {
    "id": "mtg_8f3k2j1m4n5p",
    "deleted": true,
    "permanent": true,
    "recoverable_until": null
  }
  ```
</ResponseExample>

<Warning>
  Permanent deletion is irreversible. The meeting, its transcript, summary, recording file, and all associated action items will be removed. This operation cannot be undone.
</Warning>

<Note>
  Soft-deleted meetings can be restored within 30 days by contacting [support@mavioapp.com](mailto:support@mavioapp.com). After 30 days, soft-deleted data is automatically purged.
</Note>