SnozeDevelopers
API referenceSurfaces

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.

POST
/v1/workspaces/{workspaceId}/surfaces/{surfaceId}/comments/{commentId}/resolve

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

Request Body

application/json
  1. body
resolved*boolean
clientMutationId?string|null

Response Body

Success

application/json
  1. response
data*
Example Request
curl -X POST 'https://api.snoze.dev/v1/workspaces/string/surfaces/string/comments/string/resolve' \  -H 'Content-Type: application/json' \  -d '{  "resolved": true}'
Example Response
{  "data": {    "id": "string",    "workspaceId": "string",    "surfaceId": "string",    "blockId": "string",    "authorUserId": "string",    "authorDisplayName": "string",    "authorAvatarUrl": "string",    "body": "string",    "content": [],    "resolvedAt": "string",    "createdAt": "string"  }}

Comment on a block

Creates a comment anchored to one block of the surface, optionally at a client-supplied id so a text selection can be marked before the row exists. Requires `blocks:comment` on the surface. Fails with a not-found error when the surface or block does not exist and with a validation error when the body is empty or longer than 2,000 characters.

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.