API reference

Base URL

https://api.diagrams.so/api/v2

All endpoints require a bearer API key (see Authentication) and return JSON.

Auth: send Authorization: Bearer dgz_live_YOUR_API_KEY on every request.
Content type: use application/json for request bodies.
IDs: every diagram has an id. Pass it between endpoints.
Plans: both plans are unlimited and nothing is metered. On Free, replies carry xml: null and a link to a watermarked SVG. See Free plan replies.
Errors: a consistent envelope with code, message, and request_id. See Errors.
Rate limits: per key and per IP. A 429 means slow down. See Rate limits.
Idempotency: send Idempotency-Key on create calls. See Idempotency.

Diagrams

Method	Path	Purpose
POST	`/diagrams`	Generate from a prompt.
POST	`/diagrams/stream`	Generate with progress streaming.
GET	`/diagrams`	List your diagrams.
GET	`/diagrams/{id}`	Read a diagram.
PATCH	`/diagrams/{id}`	Update metadata.
DELETE	`/diagrams/{id}`	Delete a diagram.
POST	`/diagrams/{id}/edit`	Edit with a prompt.
POST	`/diagrams/{id}/fix`	Fix a warning.
POST	`/diagrams/import`	Import a draw.io file.
GET	`/diagrams/{id}/export`	Export SVG, or draw.io on Paid.

Async and versions

Method	Path	Purpose
POST	`/diagrams/{id}/relayout`	Start a re-layout job.
GET	`/diagrams/{id}/relayout/{job_id}`	Poll the job.
GET	`/diagrams/{id}/versions`	List versions.
GET	`/diagrams/{id}/versions/{version_id}`	Read a version.
POST	`/diagrams/{id}/revert`	Revert to a version.

Warnings, gallery, prompts

Usage, meta, account

That is the complete surface: 27 operations.