Skip to content

Document inline comment anchor fields on /comments.create#26

Merged
tommoor merged 1 commit into
mainfrom
claude/affectionate-ride-O5MTd
May 14, 2026
Merged

Document inline comment anchor fields on /comments.create#26
tommoor merged 1 commit into
mainfrom
claude/affectionate-ride-O5MTd

Conversation

@tommoor
Copy link
Copy Markdown
Member

@tommoor tommoor commented May 13, 2026

Summary

Documents the new inline comment input parameters added to /comments.create in outline/outline#12322 ("feat: Inline comment support").

The endpoint now accepts three optional fields for anchoring a comment to a specific text range in the document:

  • anchorText — Plain text substring to anchor to. First occurrence in the document's plain text is used unless disambiguated.
  • anchorPrefix — Text immediately preceding anchorText, used to disambiguate multiple occurrences. Requires anchorText.
  • anchorSuffix — Text immediately following anchorText, used to disambiguate multiple occurrences. Requires anchorText.

The endpoint description has been updated to mention anchorText. The Comment response schema already exposes the anchorText field, so no response-shape changes are needed.

Other reviewed PRs from the last day

The following merged outline/outline PRs were reviewed and determined to have no impact on the public API contract, so no doc changes were needed:

  • #12332 — fix: Correct locking in comment anchor for update (internal locking only)
  • #12331 — chore: Upgrade Mermaid (dependency)
  • #12329 — test: Fix flaky comments.list ordering assertion (test only)
  • #12328 — fix: Batch document deletes when emptying trash (internal perf only)

Test plan

  • yarn lint --fail-severity=error passes
  • Husky pre-commit hook regenerated spec3.json from spec3.yml
  • Operation IDs validate

Generated by Claude Code

Adds anchorText, anchorPrefix, and anchorSuffix request parameters to
the comments.create endpoint, enabling creation of inline comments
attached to a specific text range in a document.
@tommoor tommoor merged commit 1f9f535 into main May 14, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants