pub struct Comment {Show 45 fields
pub id: Option<String>,
pub created_at: Option<DateTime<Utc>>,
pub updated_at: Option<DateTime<Utc>>,
pub archived_at: Option<DateTime<Utc>>,
pub body: Option<String>,
pub issue: Option<Box<Issue>>,
pub issue_id: Option<String>,
pub document_content: Option<Box<DocumentContent>>,
pub document_content_id: Option<String>,
pub project_update: Option<Box<ProjectUpdate>>,
pub project_update_id: Option<String>,
pub initiative_update: Option<Box<InitiativeUpdate>>,
pub initiative_update_id: Option<String>,
pub post: Option<Box<Post>>,
pub project: Option<Box<Project>>,
pub project_id: Option<String>,
pub initiative: Option<Box<Initiative>>,
pub initiative_id: Option<String>,
pub parent: Option<Box<Comment>>,
pub parent_id: Option<String>,
pub resolving_user: Option<Box<User>>,
pub resolved_at: Option<DateTime<Utc>>,
pub resolving_comment: Option<Box<Comment>>,
pub resolving_comment_id: Option<String>,
pub user: Option<Box<User>>,
pub external_user: Option<Box<ExternalUser>>,
pub edited_at: Option<DateTime<Utc>>,
pub body_data: Option<String>,
pub quoted_text: Option<String>,
pub reaction_data: Option<Value>,
pub thread_summary: Option<Value>,
pub is_artificial_agent_session_root: Option<bool>,
pub url: Option<String>,
pub children: Option<CommentConnection>,
pub agent_session: Option<Box<AgentSession>>,
pub agent_sessions: Option<AgentSessionConnection>,
pub spawned_agent_sessions: Option<AgentSessionConnection>,
pub ai_prompt_progresses: Option<AiPromptProgressConnection>,
pub created_issues: Option<IssueConnection>,
pub bot_actor: Option<ActorBot>,
pub on_behalf_of: Option<Box<User>>,
pub external_thread: Option<SyncedExternalThread>,
pub hide_in_linear: Option<bool>,
pub reactions: Option<Vec<Reaction>>,
pub synced_with: Option<Vec<ExternalEntityInfo>>,
}Expand description
A comment associated with an issue, project update, initiative update, document content, post, project, or initiative. Comments support rich text (ProseMirror), emoji reactions, and threaded replies via parentId. Comments can be created by workspace users or by external users through integrations (e.g., Slack, Intercom). Each comment belongs to exactly one parent entity.
Fields§
§id: Option<String>The unique identifier of the entity.
created_at: Option<DateTime<Utc>>The time at which the entity was created.
updated_at: Option<DateTime<Utc>>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.
archived_at: Option<DateTime<Utc>>The time at which the entity was archived. Null if the entity has not been archived.
body: Option<String>The comment content in markdown format. This is a derived representation of the canonical bodyData ProseMirror content.
issue: Option<Box<Issue>>The issue that the comment is associated with. Null if the comment belongs to a different parent entity type.
issue_id: Option<String>The ID of the issue that the comment is associated with. Null if the comment belongs to a different parent entity type.
document_content: Option<Box<DocumentContent>>The document content that the comment is associated with. Null if the comment belongs to a different parent entity type. Used for inline comments on documents.
document_content_id: Option<String>The ID of the document content that the comment is associated with. Null if the comment belongs to a different parent entity type.
project_update: Option<Box<ProjectUpdate>>The project update that the comment is associated with. Null if the comment belongs to a different parent entity type.
project_update_id: Option<String>The ID of the project update that the comment is associated with. Null if the comment belongs to a different parent entity type.
initiative_update: Option<Box<InitiativeUpdate>>The initiative update that the comment is associated with. Null if the comment belongs to a different parent entity type.
initiative_update_id: Option<String>The ID of the initiative update that the comment is associated with. Null if the comment belongs to a different parent entity type.
post: Option<Box<Post>>The post that the comment is associated with. Null if the comment belongs to a different parent entity type.
project: Option<Box<Project>>Internal 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.
project_id: Option<String>Internal The ID of the project that the comment is associated with. Null if the comment belongs to a different parent entity type.
initiative: Option<Box<Initiative>>Internal The initiative that the comment is associated with. Null if the comment belongs to a different parent entity type.
initiative_id: Option<String>Internal The ID of the initiative that the comment is associated with. Null if the comment belongs to a different parent entity type.
parent: Option<Box<Comment>>The parent comment under which the current comment is nested. Null for top-level comments that are not replies.
parent_id: Option<String>The ID of the parent comment under which the current comment is nested. Null for top-level comments.
resolving_user: Option<Box<User>>The user that resolved the comment thread. Null if the thread has not been resolved or if this is not a top-level comment.
resolved_at: Option<DateTime<Utc>>The time when the comment thread was resolved. Null if the thread is unresolved.
resolving_comment: Option<Box<Comment>>The child comment that resolved this thread. Only set on top-level (parent) comments. Null if the thread is unresolved.
resolving_comment_id: Option<String>The ID of the child comment that resolved this thread. Null if the thread is unresolved.
user: Option<Box<User>>The user who wrote the comment. Null for comments created by integrations or bots without a user association.
external_user: Option<Box<ExternalUser>>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.
edited_at: Option<DateTime<Utc>>The time the comment was last edited by its author. Null if the comment has not been edited since creation.
body_data: Option<String>Internal The comment content as a ProseMirror document. This is the canonical rich-text representation of the comment body.
quoted_text: Option<String>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.
reaction_data: Option<Value>Emoji reaction summary for this comment, grouped by emoji type. Each entry contains the emoji name, count, and the IDs of users who reacted.
thread_summary: Option<Value>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.
is_artificial_agent_session_root: Option<bool>Internal Whether the comment is an artificial placeholder for an agent session thread created without a comment mention.
url: Option<String>Comment’s URL.
children: Option<CommentConnection>The children of the comment.
agent_session: Option<Box<AgentSession>>Agent session associated with this comment.
agent_sessions: Option<AgentSessionConnection>Internal Agent sessions associated with this comment.
spawned_agent_sessions: Option<AgentSessionConnection>Internal Agent sessions spawned from this comment.
ai_prompt_progresses: Option<AiPromptProgressConnection>Internal AI prompt progresses associated with this comment.
created_issues: Option<IssueConnection>Issues created from this comment.
bot_actor: Option<ActorBot>The bot that created the comment.
on_behalf_of: Option<Box<User>>Internal The user on whose behalf the comment was created, e.g. when the Linear assistant creates a comment for a user.
external_thread: Option<SyncedExternalThread>The external thread that the comment is synced with.
hide_in_linear: Option<bool>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).
reactions: Option<Vec<Reaction>>Reactions associated with the comment.
synced_with: Option<Vec<ExternalEntityInfo>>The external services the comment is synced with.