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

# Get Diagram

`GET /api/diagrams/{diagram_id}`

## Request

- Base URL: `https://api.makeaviz.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.makeaviz.com/api/diagrams/{diagram_id}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/makeaviz/apis/text-to-diagram-api/docs/api/diagrams/:diagram_id/get.ts> (a function with typed inputs; its response is checked against the schema)

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.dev/makeaviz/apis/text-to-diagram-api.md) - [All operations](https://skmtc.dev/makeaviz/apis/text-to-diagram-api/llms.txt) - [OpenAPI document](https://skmtc.dev/makeaviz/apis/text-to-diagram-api/revisions/b7c00f8d19a5?raw)