Pagination

List endpoints (diagrams, versions, gallery search, and usage history) use cursor pagination.

Pass limit (default 20, max 100).
The response includes next_cursor and has_more.
To get the next page, pass the next_cursor value as cursor.

# first page
curl "https://api.diagrams.so/api/v2/diagrams?limit=50" \
  -H "Authorization: Bearer dgz_live_YOUR_API_KEY"

# next page
curl "https://api.diagrams.so/api/v2/diagrams?limit=50&cursor=NEXT_CURSOR" \
  -H "Authorization: Bearer dgz_live_YOUR_API_KEY"

Response shape

{ "items": [ ... ], "next_cursor": "...", "has_more": true }

Loop until has_more is false.

Cursors are opaque. Do not parse or construct them; only echo back what the API returned.

Getting started

Model Context Protocol (MCP)

SDKs

Guides

Billing

Resources