SnozeDevelopers
API referenceCanvas

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.

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

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

Query Parameters

cursor?string|null

Response Body

Success

application/json
  1. response
data*
Example Request
curl -X GET 'https://api.snoze.dev/v1/workspaces/string/surfaces/string/canvas/history'
Example Response
{  "data": {    "surfaceId": "string",    "headVersion": 0,    "revisions": [      {        "version": 0,        "at": "string",        "actorUserId": "string",        "actorName": "string",        "source": "person",        "label": "string",        "changedCount": 0      }    ],    "nextCursor": 0,    "undoVersion": 0,    "redoVersion": 0  }}

Undo a canvas authoring command

Applies the complete inverse of a recorded authoring command atomically, including dependent connector changes and deleted objects. Requires `canvas:write`. Refuses undo when an affected object has been changed since the original command or is locked, preserving collaborators' later work.

Preview a board version

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