| { |
| "name": "save_comment", |
| "description": "Create or update a comment on a Linear issue, project, initiative, document, or project milestone. If `id` is provided, updates the existing comment; otherwise creates a new one. To start a new thread, pass `body` and exactly one of `issueId`, `projectId`, `initiativeId`, `documentId`, or `milestoneId` — comments on issues/projects/initiatives become top-level discussion threads; comments on documents/milestones become description comments. To reply to an existing thread, pass `parentId` and `body`; the reply inherits the parent's thread type, so no entity reference is needed.", |
| "inputSchema": { |
| "$schema": "http://json-schema.org/draft-07/schema#", |
| "type": "object", |
| "properties": { |
| "id": { |
| "description": "Comment ID. If provided, updates the existing comment", |
| "type": "string" |
| }, |
| "issueId": { |
| "description": "Issue ID or identifier (e.g., LIN-123) (provide exactly one parent)", |
| "type": "string" |
| }, |
| "projectId": { |
| "description": "Project name, ID, or slug (provide exactly one parent)", |
| "type": "string" |
| }, |
| "initiativeId": { |
| "description": "Initiative name or ID (provide exactly one parent)", |
| "type": "string" |
| }, |
| "documentId": { |
| "description": "Document ID or slug (provide exactly one parent)", |
| "type": "string" |
| }, |
| "milestoneId": { |
| "description": "Milestone UUID (provide exactly one parent). Resolve milestone names via `list_milestones` first.", |
| "type": "string" |
| }, |
| "parentId": { |
| "description": "Parent comment ID (for replies, only when creating)", |
| "type": "string" |
| }, |
| "body": { |
| "type": "string", |
| "description": "Content as Markdown. Do not escape the string — use literal newlines and special characters, not escape sequences. To mention a user, use @displayName (e.g., @johndoe)" |
| } |
| }, |
| "required": [ |
| "body" |
| ], |
| "additionalProperties": false |
| } |
| } |
