---
title: "List diagrams in a file"
method: GET
path: "/api/files/{fileId}/diagrams"
---

# List diagrams in a file

`GET /api/files/{fileId}/diagrams`

Retrieves all diagrams in a file, sorted by most recently updated first.

## Path parameters

- `fileId` string, required

## Response `200`

Array of diagrams in the file

- Diagram[]
  - `id` string, required — Unique identifier for the diagram
  - `diagramUrl` string, required — URL to view the diagram in the Eraser canvas
  - `diagramType` 'sequence-diagram' | 'entity-relationship-diagram' | 'cloud-architecture-diagram' | 'flowchart-diagram' | 'bpmn-diagram', required — Type of the diagram
  - `code` string, required — Eraser DSL code for the diagram
  - `updatedAt` string, date-time, required — ISO 8601 timestamp of when the diagram was last updated

## Other responses

- `400` — Invalid file ID
- `401` — Missing or invalid bearer token
- `403` — Unauthorized
- `404` — File not found (or file is private, archived, a template, or belongs to a different team)
- `500` — Internal server error

---

[API](https://skmtc.net/eraser/apis/render.md) · [All operations](https://skmtc.net/eraser/apis/render/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/eraser/render/versions/c31350b435dc/schema)