Comment
All comments the user has access to in the workspace.
Table-Specific Information
SELECT
The add-in uses the Linear API to process WHERE clause conditions built with the following columns and operators. The rest of the filter is executed client-side within the add-in.| Column | Supported Operators |
| id | =, !=, IN, NOT IN |
| createdAt | =, !=, IN, NOT IN, <, <=, >, >= |
| updatedAt | =, !=, IN, NOT IN, <, <=, >, >= |
| body | =, !=, IN, NOT IN, LIKE, CONTAINS |
| issueId | =, !=, IN, NOT IN, IS, IS NOT |
| projectUpdateId | =, !=, IN, NOT IN, IS, IS NOT |
| initiativeUpdateId | =, !=, IN, NOT IN, IS, IS NOT |
| projectId | =, !=, IN, NOT IN, IS, IS NOT |
| initiativeId | =, !=, IN, NOT IN, IS, IS NOT |
| parentId | =, !=, IN, NOT IN, IS, IS NOT |
| userId | =, !=, IN, NOT IN |
For example, the following queries are processed server-side:
SELECT * FROM Comment LIMIT 1
SELECT * FROM Comment WHERE createdAt = '2026-01-01T00:00:00Z' LIMIT 1
INSERT
To insert a Comment record:INSERT INTO Comment (body, issueId) VALUES ('sample', '27cab3b0-a2f8-4f82-8b20-7772658f5896')
UPDATE
To update a Comment record:UPDATE Comment SET body = 'sample' WHERE id = '3a5accbe-7af9-4893-9307-c346c16e4131'
DELETE
To delete a Comment record:DELETE FROM Comment WHERE id = '3a5accbe-7af9-4893-9307-c346c16e4131'
Columns
| Name | Type | ReadOnly | Description |
| id [KEY] | String | False |
The unique identifier of the entity. |
| createdAt | Datetime | False |
The time at which the entity was created. |
| updatedAt | Datetime | True |
The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't been updated after creation. |
| archivedAt | Datetime | True |
The time at which the entity was archived. Null if the entity has not been archived. |
| body | String | False |
The comment content in markdown format. This is a derived representation of the canonical bodyData ProseMirror content. |
| issueId | String | False |
The issue that the comment is associated with. Null if the comment belongs to a different parent entity type. |
| documentContentId | String | False |
The ID of the document content that the comment is associated with. Null if the comment belongs to a different parent entity type. |
| projectUpdateId | String | False |
The project update that the comment is associated with. Null if the comment belongs to a different parent entity type. |
| initiativeUpdateId | String | False |
The initiative update that the comment is associated with. Null if the comment belongs to a different parent entity type. |
| projectId | String | False |
The project that the comment is associated with. Used for project-level discussion threads. Null if the comment belongs to a different parent entity type. |
| initiativeId | String | False |
The initiative that the comment is associated with. Null if the comment belongs to a different parent entity type. |
| parentId | String | False |
The parent comment under which the current comment is nested. Null for top-level comments that are not replies. |
| resolvingUserId | String | False |
The user that resolved the comment thread. Null if the thread has not been resolved or if this is not a top-level comment. |
| resolvedAt | Datetime | True |
The time when the comment thread was resolved. Null if the thread is unresolved. |
| resolvingCommentId | String | False |
The child comment that resolved this thread. Only set on top-level (parent) comments. Null if the thread is unresolved. |
| userId | String | True |
The user who wrote the comment. Null for comments created by integrations or bots without a user association. |
| externalUserId | String | True |
The external user who wrote the comment, when the comment was created through an integration such as Slack or Intercom. Null for comments created by workspace users. |
| editedAt | Datetime | True |
The time the comment was last edited by its author. Null if the comment has not been edited since creation. |
| bodyData | String | False |
[Internal] The comment content as a ProseMirror document. This is the canonical rich-text representation of the comment body. |
| quotedText | String | False |
The text that this comment references, used for inline comments on documents or issue descriptions. Null for standard comments that do not quote specific text. |
| reactionData | String | True |
Emoji reaction summary for this comment, grouped by emoji type. Each entry contains the emoji name, count, and the IDs of users who reacted. |
| threadSummary | String | True |
[Internal] An AI-generated summary of the comment thread. Null if no summary has been generated or if this is not a top-level comment. |
| isArtificialAgentSessionRoot | Bool | True |
[Internal] Whether the comment is an artificial placeholder for an agent session thread created without a comment mention. |
| url | String | True |
Comment's URL. |
| agentSessionId | String | True |
Agent session associated with this comment. |
| onBehalfOfId | String | True |
[Internal] The user on whose behalf the comment was created, e.g. when the Linear assistant creates a comment for a user. |
| hideInLinear | Bool | True |
[Internal] Whether the comment should be hidden from Linear clients. This is typically used for bot comments that provide redundant information (e.g., Slack Asks confirmation messages). |