---
title: "Get Diagram"
method: GET
path: "/api/diagrams/{diagram_id}"
tags: ["Diagrams"]
---

# Get Diagram

`GET /api/diagrams/{diagram_id}`

Get a specific diagram by ID.

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

Args:
    diagram_id: ID of the diagram to retrieve
    db: Database session
    current_user: Authenticated user

Returns:
    DiagramResponse with diagram data

Raises:
    404: If diagram not found or doesn't belong to user

## Path parameters

- `diagram_id` integer, required

## Response `200`

Successful Response

- DiagramResponse — Response model for diagram data.
  - `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)

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