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

# List diagrams

> Retrieve a list of diagrams generated from a meeting.

Returns all diagrams that have been generated for a specific meeting. Diagrams are AI-generated visual representations of meeting content, including flowcharts, sequence diagrams, mind maps, and infographics.

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

<ParamField query="limit" type="integer" default="20">
  Number of diagrams to return per page. Must be between 1 and 100.
</ParamField>

<ParamField query="offset" type="integer" default="0">
  Number of diagrams to skip for pagination.
</ParamField>

<ParamField query="type" type="string">
  Filter by diagram type. One of `flowchart`, `sequence`, `mindmap`, or `infographic`.
</ParamField>

### Response

<ResponseField name="data" type="array">
  An array of diagram objects.

  <Expandable title="Diagram object">
    <ResponseField name="id" type="string">
      Unique diagram identifier (e.g., `dgm_a1b2c3d4e5`).
    </ResponseField>

    <ResponseField name="meeting_id" type="string">
      The meeting this diagram was generated from.
    </ResponseField>

    <ResponseField name="type" type="string">
      Diagram type: `flowchart`, `sequence`, `mindmap`, or `infographic`.
    </ResponseField>

    <ResponseField name="title" type="string">
      Auto-generated title describing the diagram content.
    </ResponseField>

    <ResponseField name="status" type="string">
      Generation status: `processing`, `completed`, or `failed`.
    </ResponseField>

    <ResponseField name="image_url" type="string | null">
      URL to the rendered diagram image (PNG). `null` if still processing.
    </ResponseField>

    <ResponseField name="source_markup" type="string | null">
      The Mermaid or SVG markup used to generate the diagram. `null` if still processing.
    </ResponseField>

    <ResponseField name="created_at" type="string">
      ISO 8601 timestamp when the diagram was requested.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="pagination" type="object">
  Pagination metadata.

  <Expandable title="Pagination object">
    <ResponseField name="total" type="integer">
      Total number of diagrams for this meeting.
    </ResponseField>

    <ResponseField name="limit" type="integer">
      The limit used in this request.
    </ResponseField>

    <ResponseField name="offset" type="integer">
      The offset used in this request.
    </ResponseField>

    <ResponseField name="has_more" type="boolean">
      Whether there are more results beyond this page.
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -G https://api.mavioapp.com/v1/meetings/mtg_8f3k2j1m4n5p/diagrams \
    -H "Authorization: Bearer mvo_live_abc123" \
    -d type=flowchart
  ```

  ```python Python theme={null}
  diagrams = client.diagrams.list(
      meeting_id="mtg_8f3k2j1m4n5p",
      type="flowchart"
  )
  for d in diagrams.data:
      print(f"{d.title} ({d.type}) — {d.status}")
  ```

  ```javascript Node.js theme={null}
  const { data: diagrams } = await client.diagrams.list('mtg_8f3k2j1m4n5p', {
    type: 'flowchart',
  });
  diagrams.forEach(d => {
    console.log(`${d.title} (${d.type}) — ${d.status}`);
  });
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "data": [
      {
        "id": "dgm_a1b2c3d4e5",
        "meeting_id": "mtg_8f3k2j1m4n5p",
        "type": "flowchart",
        "title": "Launch Timeline Decision Flow",
        "status": "completed",
        "image_url": "https://storage.mavioapp.com/diagrams/dgm_a1b2c3d4e5.png",
        "source_markup": "graph TD\n  A[Start] --> B{Stripe Ready?}\n  B -->|Yes| C[Proceed with April 20 Launch]\n  B -->|No| D[Delay to April 27]\n  C --> E[QA Sprint]\n  E --> F[Staging Deploy]\n  F --> G[Production Launch]",
        "created_at": "2026-04-10T15:05:00Z"
      },
      {
        "id": "dgm_f6g7h8i9j0",
        "meeting_id": "mtg_8f3k2j1m4n5p",
        "type": "flowchart",
        "title": "Bug Triage Process",
        "status": "completed",
        "image_url": "https://storage.mavioapp.com/diagrams/dgm_f6g7h8i9j0.png",
        "source_markup": "graph TD\n  A[New Bug] --> B{Severity?}\n  B -->|Critical| C[Fix Immediately]\n  B -->|High| D[Next Sprint]\n  B -->|Low| E[Backlog]",
        "created_at": "2026-04-10T15:10:00Z"
      }
    ],
    "pagination": {
      "total": 2,
      "limit": 20,
      "offset": 0,
      "has_more": false
    }
  }
  ```
</ResponseExample>