View as Markdown
Linear (API key) icon

Linear (API key) ACTION

Create Document Comment

Add a comment to a Linear document, or reply to an existing comment on it. Use Search Documents to find the document ID, and List Document Comments to find a comment ID to reply to. For comments on issues use Create Comment instead. A reply's parent must be a top-level comment on the same document (Linear allows only one level of replies). Returns success and the new comment's id, body, createdAt, parent, and author. Example: documentId: "10b5bc2940c7", body: "Looks good, one question on the rollout plan." → returns {success: true, comment: {id: "cmt_xyz", body: "Looks good, one question on the rollout plan.", parent: null}}. See the documentation
  • Action
  • Writes data
  • API key
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Linear (API key) account once, then configure and run Create Document Comment from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "linear_app-create-document-comment",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    linear_app: { authProvisionId: "apn_xxxxxxx" },
    documentId: "Document ID",
    body: "Body",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Create Document Comment inputs
Property Type Description
documentId Document ID string
The document to comment on: its UUID or slugId (the short code at the end of the document URL, e.g. 10b5bc2940c7). Use Search Documents to find document IDs.
Required
body Body string
The content of the comment in markdown format. Example: Looks good, one question on the rollout plan.
Required
parentId Parent Comment ID string
The ID of an existing top-level comment on this document to reply to (a UUID, e.g. 2160d3b4-99a7-41ad-a24f-b2f28ef7d320). Linear allows only one level of replies, so don't pass the ID of a reply: top-level comments have parent: null, and for a reply use its parent ID instead. Leave blank to post a new top-level comment. Use List Document Comments to find comment IDs.
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
linear_app-create-document-comment
Version
0.0.1
App
Linear (API key)
Authentication
API key
Read-only
No
Destructive
No
Open world
Yes