---
title: "List Diagrams"
method: GET
path: "/api/diagrams"
tags: ["Diagrams"]
---

# List Diagrams

`GET /api/diagrams`

List all diagrams for the authenticated user.

**AUTHENTICATION REQUIRED** - Must include valid JWT token in Authorization header.

Args:
    skip: Number of records to skip (pagination)
    limit: Maximum number of records to return (max 100)
    db: Database session
    current_user: Authenticated user

Returns:
    DiagramListResponse with list of diagrams and total count

## Query parameters

- `skip` integer
- `limit` integer

## Response `200`

Successful Response

- DiagramListResponse — Response model for diagram list.
  - `diagrams` DiagramResponse[], required — List of diagrams
    - `id` integer, required — Diagram ID
    - `user_id` integer, required — User ID who created the diagram
    - `title` string, required — Diagram title
    - `description` string, nullable — Original user description
    - `mermaid_code` string, required — Mermaid diagram syntax
    - `diagram_type` string — Type of diagram (flowchart, sequence, or mindmap)
    - `diagram_json` object, required — Complete diagram state: nodes, edges, layoutDirection, positions, customizations
    - `created_at` string, required — Creation timestamp (ISO format)
    - `updated_at` string, required — Last update timestamp (ISO format)
  - `total` integer, required — Total number of diagrams for the user

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/makeaviz/apis/text-to-diagram-api.md) · [All operations](https://skmtc.net/makeaviz/apis/text-to-diagram-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/makeaviz/text-to-diagram-api/versions/b7c00f8d19a5/schema)