Diagrams

Get a diagram's full schema document

The verbatim, re-importable DrawSQL JSON document for a diagram: the same denormalized shape as /schema, plus layout (positions, colors, sizes), groups, and sticky_notes. This is the native canvas format, minus only security-sensitive persistence fields.

The curated /schema profile is a strict subset of this document. Supports ETag conditional requests. Here the ETag tracks the schema revision, so ANY edit (including a canvas-only layout change) yields a new ETag. Rate limit: 30 requests/minute per token.

get/diagrams/{uuid}/schema-full

Request

  • Base URL
    https://api.drawsql.app/v1
  • Auth
    HTTP bearer

Path parameters

uuidstring uuid required
Example:123e4567-e89b-12d3-a456-426614174000

The diagram's UUID.

Headers

If-None-Matchstring

An ETag from a previous response. Returns 304 if unchanged.

Response

The full schema document.

Example response

{
  "data": {
    "driver": "mysql",
    "tables": [
      {
        "record_type": "table",
        "indexes": [
          {
            "type": "index"
          }
        ]
      }
    ],
    "relationships": [
      {
        "type": "one-to-one",
        "record_type": "relationship"
      }
    ],
    "groups": [
      {
        "record_type": "group"
      }
    ],
    "sticky_notes": [
      {
        "record_type": "sticky-note"
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.