SnozeDevelopers
API referenceDatabases

Comment on a record

Adds a comment to the record, attributed to the calling user's synced profile. Requires the `records:comment` permission on the database, and rejects an empty body or one longer than 2,000 characters.

POST
/v1/workspaces/{workspaceId}/databases/{databaseId}/records/{recordId}/comments

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
databaseId*string
recordId*string

Request Body

application/json
  1. body
id?|null
body*string
content?array<>|null
clientMutationId?string|null

Response Body

Success

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

List the comments on a record

Returns the record's comments with each author's display name and avatar. Requires the `records:read` permission on the database.

Delete a comment on a record

Removes one comment from the record. An author may always delete their own comment; deleting someone else's additionally requires the `records:write` permission. Responds with not-found for a comment that is not on this record.