[giladresisi]

⚠️ Merge only after gitroomhq/postiz-app#2249 is deployed to production

Until then the mention tool does not exist in the public API and the documented call fails.

Documents tagging LinkedIn company pages through the public API, which gitroomhq/postiz-app#2249 enables by exposing LinkedIn's mention lookup as a provider tool.

• public-api/providers/linkedin.mdx: new "Mentioning a Company Page" section with the integration-trigger call (methodName: "mention", exact vanity name), the response shape, the span format for the post content, and a note that only company pages can be tagged.
• public-api/providers/linkedin-page.mdx: one line pointing to that section, since LinkedIn Page channels share the same tool.

Verified against a local build of that app PR: the documented microsoft example returns Microsoft's company id, a handle that does not exist returns an empty output, and content in the documented span format was published to a real LinkedIn Page with the company name rendered as a link to its page.

CLI counterpart: gitroomhq/postiz-agent#31

🤖 Generated with Claude Code

Summary by CodeRabbit

• Documentation
  • Added instructions for mentioning LinkedIn company pages in posts, including how to find a page ID and format the mention.
  • Clarified that company-page mentions work the same way in LinkedIn Page settings. Member searches aren’t supported.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

• Configuration used: defaults
• Review profile: CHILL
• Plan: Advanced
• Run ID: b9b03cb4-a2d8-4b6a-9c61-ec7d58eb916a

📥 Commits

Reviewing files that changed from the base of the PR and between 9c2e222 and 091260e.

📒 Files selected for processing (2)

• public-api/providers/linkedin-page.mdx
• public-api/providers/linkedin.mdx

Included review availability: This review used your included allowance. Your plan provides up to 1 included review per hour; 0 remain after this review.

📝 Walkthrough

The LinkedIn guides now document how to look up and tag company pages. The instructions describe the lookup request, the markup for post content, and the restriction against looking up people.

Changes: LinkedIn company-page mentions

Layer / File(s)	Summary
Company-page mention instructions public-api/providers/linkedin.mdx, public-api/providers/linkedin-page.mdx	The LinkedIn guide documents looking up a company page by its exact vanity name with the mention tool, using the returned ID and label in post content, and the restriction against looking up people. The LinkedIn Page guide links to these instructions.

Priority: ⬇️ Low

Estimated code review effort: 1 (Trivial) | ~5 minutes

Change: Other

Merge Risk: ⚪ Minimal · up to 09126

This PR adds documentation for tagging LinkedIn company pages. The docs call a tool that, per the author, is not available until a separate app PR is deployed. Merge after that deployment, as the author notes.

### Architecture Summary

Architecture risk: 🔵 Low · up to 09126

The change affects 1 system.

Changed systems: public-api

Architecture concerns
No architecture-level concerns identified.

Review details

Systems and components

• observed — public-api (service) was modified; 2 changed files map to changed impact.

Before / after behavior

• observed — Modified behavior in public-api/providers/linkedin-page.mdx: Adds a link to the LinkedIn guide’s “Mentioning a Company Page” section and states that company-page tagging works the same way.
• observed — Modified behavior in public-api/providers/linkedin.mdx: Adds instructions and a curl example for looking up a company page by its exact vanity name using the mention tool. Shows how to place the returned ID and label in a content span and states that it renders as a company-page link after publication. Documents that only company pages can be looked up; people cannot be tagged this way.

Pre-merge checks · 5

Passed checks (5 passed)

Check name	Status	Explanation
Docstring Coverage		No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff. Analyzed 0 functions across 0…
Linked Issues check		Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check		Check skipped because no linked issues were found for this pull request.
Description Check		Check skipped - CodeRabbit’s high-level summary is enabled.
Title check		The title clearly and concisely describes the main documentation change: using the LinkedIn mention tool to tag company pages.

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Commit to this branch
• Create a new PR

• Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}