Outline Wiki icon

Outline Wiki

Interact with the Outline Wiki API — documents, collections, comments, attachments, users, shares

Actions31

Comment → Create

AI-generated

Summary

Create a new comment on a specified Outline Wiki document, optionally as a reply to an existing comment for threaded discussions.

Inputs

  • Document ID (required) — UUID of the document to comment on.
  • Text (required) — Comment body written in Markdown format.
  • Parent Comment ID — UUID of the parent comment to reply to, enabling threaded replies.

Output shape

a single comment object in JSON format representing the created comment

Returns the comment details as JSON. The operation requires the Document ID and the comment text. Optionally accepts a Parent Comment ID for nested comments. Errors are returned if required fields are missing or API calls fail.

Examples

Example 1: Create a top-level comment on a document

Provide the Document ID and Text fields; do not set Parent Comment ID.

Example 2: Reply to an existing comment

Provide the Document ID, Text, and Parent Comment ID to reply within a thread.

Links

Discussion