curl https://api.bottari.ai/v1/comments/exampleCmt01 \
-H "Authorization: Bearer $BOTTARI_TOKEN" \
-H "Bottari-Version: 2026-03-11"
{
"object": "comment",
"id": "exampleCmt01",
"parent": {
"type": "page_id",
"page_id": "exampleRow01"
},
"discussion_id": "exampleCmt01",
"created_time": "2026-01-15T02:30:00.000Z",
"last_edited_time": "2026-01-15T02:45:00.000Z",
"created_by": {
"object": "user",
"id": "11111111-1111-4111-8111-111111111111"
},
"rich_text": [
{
"type": "text",
"text": {
"content": "Looks good.",
"link": null
},
"annotations": {
"bold": false,
"italic": false,
"strikethrough": false,
"underline": false,
"code": false,
"color": "default"
},
"plain_text": "Looks good.",
"href": null
}
],
"display_name": {
"type": "user",
"resolved_name": "Alex Kim"
},
"original_content_deleted": false,
"has_pending_attachments": false,
"request_id": "33333333-3333-4333-8333-333333333333"
}
{
"object": "error",
"status": 404,
"code": "object_not_found",
"message": "Could not find comment with ID: exampleCmt01.",
"request_id": "33333333-3333-4333-8333-333333333333"
}
Comments
Retrieve a comment
Read one comment or reply, including deleted ones.
GET
/
v1
/
comments
/
{id}
curl https://api.bottari.ai/v1/comments/exampleCmt01 \
-H "Authorization: Bearer $BOTTARI_TOKEN" \
-H "Bottari-Version: 2026-03-11"
{
"object": "comment",
"id": "exampleCmt01",
"parent": {
"type": "page_id",
"page_id": "exampleRow01"
},
"discussion_id": "exampleCmt01",
"created_time": "2026-01-15T02:30:00.000Z",
"last_edited_time": "2026-01-15T02:45:00.000Z",
"created_by": {
"object": "user",
"id": "11111111-1111-4111-8111-111111111111"
},
"rich_text": [
{
"type": "text",
"text": {
"content": "Looks good.",
"link": null
},
"annotations": {
"bold": false,
"italic": false,
"strikethrough": false,
"underline": false,
"code": false,
"color": "default"
},
"plain_text": "Looks good.",
"href": null
}
],
"display_name": {
"type": "user",
"resolved_name": "Alex Kim"
},
"original_content_deleted": false,
"has_pending_attachments": false,
"request_id": "33333333-3333-4333-8333-333333333333"
}
{
"object": "error",
"status": 404,
"code": "object_not_found",
"message": "Could not find comment with ID: exampleCmt01.",
"request_id": "33333333-3333-4333-8333-333333333333"
}
Reads one comment or reply. Requires Read comments. The fields are the same as in List comments.
See Common rules for shared errors.
string
Optional. Only
2026-03-11 is accepted. Without it, the current version is used. A different value returns 400.string
required
The comment ID. You can pass
entity.id from a comment.* event as is.Response by state
| Comment | Response |
|---|---|
| Deleted | 200 with rich_text: [] and original_content_deleted: true. parent is the value from before deletion. |
| Edited | The new text. last_edited_time differs from created_time. Both are truncated to the minute, so an edit within a minute can show the same value. |
| Resolved | Reads normally. No field shows that it’s resolved. |
| Block is gone | Has the text, with original_content_deleted: true. |
| On a trashed row | rich_text: [] and original_content_deleted: true. |
Errors
| Status | code | Cause |
|---|---|---|
| 403 | restricted_resource | Read comments is off. |
| 404 | object_not_found | The comment doesn’t exist, or it’s on a document the integration can’t read. |
curl https://api.bottari.ai/v1/comments/exampleCmt01 \
-H "Authorization: Bearer $BOTTARI_TOKEN" \
-H "Bottari-Version: 2026-03-11"
{
"object": "comment",
"id": "exampleCmt01",
"parent": {
"type": "page_id",
"page_id": "exampleRow01"
},
"discussion_id": "exampleCmt01",
"created_time": "2026-01-15T02:30:00.000Z",
"last_edited_time": "2026-01-15T02:45:00.000Z",
"created_by": {
"object": "user",
"id": "11111111-1111-4111-8111-111111111111"
},
"rich_text": [
{
"type": "text",
"text": {
"content": "Looks good.",
"link": null
},
"annotations": {
"bold": false,
"italic": false,
"strikethrough": false,
"underline": false,
"code": false,
"color": "default"
},
"plain_text": "Looks good.",
"href": null
}
],
"display_name": {
"type": "user",
"resolved_name": "Alex Kim"
},
"original_content_deleted": false,
"has_pending_attachments": false,
"request_id": "33333333-3333-4333-8333-333333333333"
}
{
"object": "error",
"status": 404,
"code": "object_not_found",
"message": "Could not find comment with ID: exampleCmt01.",
"request_id": "33333333-3333-4333-8333-333333333333"
}