---
title: "Delete a diagram"
method: DELETE
path: "/api/files/{fileId}/diagrams/{diagramId}"
---

# Delete a diagram

`DELETE /api/files/{fileId}/diagrams/{diagramId}`

Permanently deletes a diagram from a file's canvas. This action cannot be undone.

## Path parameters

- `fileId` string, required
- `diagramId` string, required

## Response `200`

The diagram was deleted successfully

- object
  - `deleted` boolean, required — Whether the diagram was deleted
  - `fileUrl` string, required — URL of the file that contained the diagram

## Other responses

- `400` — Invalid file ID or diagram ID
- `401` — Missing or invalid bearer token
- `403` — Unauthorized
- `404` — File or diagram not found
- `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)