SnozeDevelopers
API referenceCanvas

Preview a board version

Reconstructs a complete board version from its persisted baseline and revisions. Requires canvas:read. No content is written by previewing.

GET
/v1/workspaces/{workspaceId}/surfaces/{surfaceId}/canvas/history/{version}

Authorization

apiKey
headerAuthorizationBearer <snoze_sk_…>

Workspace API key created in Workspace settings → API keys. Scopes on the key bound what it can read and write.

Path Parameters

workspaceId*string
surfaceId*string
version*string

Response Body

Success

application/json
  1. response
data*
Example Request
curl -X GET 'https://api.snoze.dev/v1/workspaces/string/surfaces/string/canvas/history/string'
Example Response
{  "data": {    "surfaceId": "string",    "version": 0,    "elements": [      {        "id": "string",        "workspaceId": "string",        "surfaceId": "string",        "type": "rectangle",        "x": 0,        "y": 0,        "w": 0,        "h": 0,        "angle": 0,        "version": 0,        "versionNonce": 0,        "index": "string",        "isDeleted": true,        "props": {},        "createdAt": "string",        "updatedAt": "string"      }    ]  }}

Browse persistent board history

Lists recorded board revisions, their editors and AI provenance, and this caller's durable undo/redo targets. Requires canvas:read. History is paginated by version and respects the workspace plan's history window.

Restore a board version

Restores a recorded version atomically and records the restoration as a new revision. Requires canvas:write; rejects a changed history head or locked affected objects.