SnozeDevelopers
API referenceSurfaces

Delete a block comment

Removes the comment from the surface and records the deletion in the workspace event log. The comment's author may delete their own comment with `blocks:read`; deleting someone else's requires `blocks:write` on the surface. Returns a not-found error for an unknown surface or comment.

DELETE
/v1/workspaces/{workspaceId}/surfaces/{surfaceId}/comments/{commentId}

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
commentId*string

Response Body

Success

application/json
  1. response
data*
Example Request
curl -X DELETE 'https://api.snoze.dev/v1/workspaces/string/surfaces/string/comments/string'
Example Response
{  "data": {    "id": "string"  }}

Resolve or reopen a block comment

Sets or clears the comment's resolved marker according to the `resolved` flag and returns the updated comment. Requires `blocks:comment` on the surface. Returns a not-found error when the surface or comment does not exist.

List the elements on a canvas surface

Returns canvas elements and their workspace version. Optional limit (1–2000) bounds the database read and returns hasMore; omitted limit returns the full scene for editors. Requires `canvas:read` on the surface. Returns a not-found error when the workspace has no surface with that id.