docs(pinterest): board must be the numeric board id

[giladresisi]

DO NOT MERGE until the postiz-app PR gitroomhq/postiz-app#2049 is deployed. The 400 validation error described here does not exist until then.

Updates the board section of the Pinterest public API page: the value is the numeric board id, a board name is rejected with a 400 at scheduling time, and ids come from the channel's boards tool (integration settings/trigger endpoints) or the Postiz UI. Examples already used numeric ids and are unchanged.

Why: in the 7 days ending 2026-09-09, 152 Pinterest pins scheduled via the public API and MCP failed at publish because board held a board name; the app PR rejects those at scheduling, and the docs need to say so.

Merge order: postiz-app first, then this PR and the postiz-agent PR.

🤖 Generated with Claude Code

https://claude.ai/code/session_01Cb2afwuxqmE9PKj4qvNE2Q

Summary by CodeRabbit

• Documentation
  • Clarified that Pinterest board settings require a numeric board ID, not a board name.
  • Documented the resulting validation error when an invalid board name is provided.
  • Updated guidance for finding board IDs through the available integration tools and Postiz UI.

[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: f9c1cab1-cc5c-43dd-bfe0-6ffdd696611e

📥 Commits

Reviewing files that changed from the base of the PR and between 40d306f and 4ec6463.

📒 Files selected for processing (1)

• public-api/providers/pinterest.mdx

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

---

📝 Walkthrough

Walkthrough

The Pinterest settings reference now requires numeric board IDs, documents the validation error for board names, and provides updated instructions for finding board IDs.

Changes

Pinterest board ID documentation

Layer / File(s)	Summary
Board field documentation public-api/providers/pinterest.mdx	The board field now requires a numeric board ID. The documentation states that board names cause a 400 validation error and directs readers to the channel’s boards tool or the Postiz UI for board IDs.

Priority: ⬇️ Low

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

Merge Risk: ⚪ Minimal · up to 4ec64

Pinterest API documentation now tells users to provide numeric board IDs, explains the validation error for board names, and directs them to supported ID lookup paths. The change is ready to merge.

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly and concisely describes the main documentation change: Pinterest requires a numeric board ID.
Docstring Coverage	✅ Passed	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	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

✨ Finishing Touches 💡 1

🛠️ Fix failing CI checks 💡

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch docs/pinterest-board-id

---

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.}

[postiz-agent]

✅ Snyk checks have passed. No issues have been found so far.

Status	Scan Engine	Critical	High	Medium	Low	Total (0)
✅	Code Security	0	0	0	0	0 issues

💻 Catch issues earlier using the plugins for VS Code, JetBrains IDEs, Visual Studio, and Eclipse.